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内 容 提 要 


本 书 全 面 讲解 C# 并 发 编程 技术 ,侧重 于 .NET 平台 上 较 新 . 较 实 用 的 方法 。 全 书 分 为 几 大 部 分 : 
首先 介绍 几 种 并 发 编程 技术 ， 包 括 异步 编程 、 并 行 编程 、TPL 数据 流 、 响 应 式 编 程 ; 然后 阐述 一 
些 重要 的 知识 点 ， 包 括 测 试 技巧 、 互 操作 、 取 消 并 发 、 函 数 式 编程 与 OOP、 同 步 、 调 度 ; 最 后 介 
绍 了 几 个 实用 技巧 。 全 书 共 包 含 70 多 个 有 配套 源码 的 实用 方法 ， 可 用 于 服务 器 程序 、 桌 面 程序 和 
移动 应 用 的 开发 。 

本 书 适 合 具 有 .NET 基础 ， 和 希望 学 习 最 新 并 发 编程 技术 的 开发 人 员 阅 读 。 
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关于 并 发 编程 的 几 个 误解 


关于 并 发 编程 ， 很 多 人 都 有 一 些 误 解 。 


误解 一 : 并 发 就 是 多 线程 
实际 上 多 线程 只 是 并 发 编程 的 一 种 形式 ， 在 c# 中 还 有 很 多 更 实用 、 更 方便 的 并 发 编程 技 
术 ， 包 括 异步 编程 、 并 行 编程 、TPL 数据 流 、 响 应 式 编程 等 。 


误解 二 : 只 有 大 型 服务 器 程序 才 需 要 考虑 并 发 

服务 器 端的 大 型 程序 要 响应 大 量 客户 端 的 数据 请 求 ， 当 然 要 充分 考虑 并 发 。 但 是 桌面 程序 
和 手机 、 平 板 等 移动 端 应 用 同样 需要 考虑 并 发 编程 ， 因 为 它们 是 直接 面向 最 终 用 户 的 ， 而 
现在 用 户 对 使 用 体验 的 要 求 越 来 越 高 。 程 序 必 须 能 随时 响应 用 户 的 操作 ， 尤 其 是 在 后 台 处 
时 时 ( 读 写 数据 、 与 服务 器 通信 等 )， 这 正 是 并 发 编程 的 目的 之 一 。 


ae al 

C# 和 .NET 提供 了 很 多 程序 库 ， 并 发 编程 已 经 变 得 简单 多 了 。 尤 其 是 .NET 4.5 推出 了 全 新 
的 async 和 await 关键 字 ， 使 并 发 编程 的 代码 减少 到 了 最 低 限 度 。 并 行 处 理 和 异步 开发 已 
经 不 再 是 高 手 们 的 专利 ， 只 要 使 用 本 书 中 的 方法 ， 每 个 开发 人 员 都 能 写 出 交互 性 良好 、 高 
效 、 可 靠 的 并 发 程序 。 


本 书 的 特色 


本 书 全 面 讲解 C# 并 发 编程 技术 ， 侧 重 于 .NET 平台 上 较 新 、 较 实用 的 方法 。 全 书 分 为 几 大 
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: 首先 介绍 几 种 并 发 编程 技术 ， 包 括 异 步 编 程 、 并 行 编程 、TPL 数据 流 、 响 应 式 编程 
然后 是 一 些 重要 的 知识 点 ， 包 括 测 试 技巧 、 互 操作 、 取 消 并 发 、 函 数 式 编程 与 OOP、 
同步 调度 等 ， 最 后 介绍 了 几 个 实用 技巧 。 书 中 包含 70 多 个 配 有 源码 的 实用 方法 ， 可 用 
于 服务 器 程序 、 桌 面 程 序 和 移动 端 应 用 的 开发 。 


本 书 填补 了 一 个 市 场 空白 : 它 是 一 本 用 最 新 方法 进行 并 发 编程 的 入 门 指引 和 参考 书 。 


本 书 作 者 Stephen Cleary 是 美国 著名 的 软件 开发 者 和 技术 书 作 家 、C# MVP， 在 C#WC++/ 
JavaScript 等 方面 均 有 丰富 的 经 验 。 我 非常 有 地 能 翻译 他 的 车 作 。 


翻译 中 的 一 点 感 


过 去 的 十 多 年 我 一 直 在 从 事 软 件 开发 和 设计 工作 。 相 信 国 内 很 多 开发 人 员 都 和 我 一 样 ， 心 
中 存在 着 一 个 疑惑 ， 我 国 的 软件 人 员 很 多 〈 绝 对 数量 不 会 比美 国 少 )， 但 为 什么 软件 技术 
总 体 上 落后 欧美 国家 那么 多 ? 确定 翻译 《C# 并 发 编程 经 典 实例 》 这 本 书后 ， 我 一 边 仔细 
阅读 原 书 ， 一 边 遵循 作者 的 思路 ， 逐 渐 发 现 作者 思 芳 问题 的 一 个 理念 。 这 就 是 按 软件 的 不 
同 层 次 进行 明确 分 工 ， 我 只 负责 我 所 实现 的 这 个 层次 ， 底 层 技术 是 为 上 层 服 务 的 ， 我 只 人 负 
责 选 择 和 调用 ， en 同样 ， 我 负责 的 层次 为 更 高 一 层 的 软件 提供 服务 
供 上 层 调用 ， 也 不 需要 上 层 关心 我 的 内 部 实现 。 


由 此 想到 ， 这 正好 反映 出 国内 开发 人 员 中 的 一 个 通病 ， 即 分 工 不 够 细 、 技 术 关注 不 够 精 。 
很 多 公司 和 团队 在 开发 时 都 喜欢 大 包 大 挠 ， 从 底层 到 应 用 层 全 部 自己 实现 ， 很 多 开发 人 员 
也 热 圳 于 “大 而 全 ”地 学 习 技 术 ， 试 图 掌握 软件 开发 中 的 各 种 技术 ， 而 不 是 精通 某 一 方 
面 。 其 至 流行 这 样 一 种 观点 ， 实 现 底层 软件 、 写 驱动 的 才 是 高 级 开发 人 员 ， 做 上 层 应 用 的 
人 仅仅 是 “ 码 农 "。 本 书 作者 明确 地 反对 了 这 种 看 法 ， 书 中 强调 如 何 利用 好 现成 的 库 ， 而 
不 是 全 部 采用 底层 技术 自己 实现 。 利 用 现成 的 库 开发 出 高 质量 的 软件 ， 对 技术 能 力 的 考验 
并 不 低 于 开发 底层 库 。 


感谢 
在 本 书 的 翻译 过 程 中 ， 得 到 了 图 灵 公 司 李 松 峰 老师 的 支持 和 帮助 ， 在 此 表示 感谢 。 由 于 本 
人 水 平 有 限 ， 书 中 难免 有 足 色 和 错误 ， 有 恳请 读者 朋友 们 批评 指正 
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我 觉得 封面 上 的 动物 〈 廊 香 猫 ) 能 体现 出 本 书 的 主题 。 在 看 到 这 个 封面 之 前 ， 我 对 这 种 动 
物 一 无 所 知 ， 因 此 特意 查 了 一 下 。 廊 香 猫 会 在 天 花 板 和 癌 楼 上 随处 便 滑 ， 并 且 在 最 不 合 时 
宜 的 情况 下 互相 打斗 发 出 很 大 的 噪音 ， 因 此 被 认为 是 一 种 害 曾 。 它 们 肛门 处 的 气味 腺 会 
分 泌 一 种 令 人 作呕 的 分 泌 物 。 在 动物 保护 分 类 中 ， 廊 香 猫 属于 “无 危 物 种 ”， 这 相当 于 说 
“人 们 可 以 随意 捕杀 ， 没 人 会 在 乎 "。 魔 香 猫 喜 欢 吃 咖啡 果 ， 并 且 吃 完 咖啡 豆 之 后 不 消化 ， 
又 排泄 出 来 。 世 界 上 最 贵 的 咖啡 之 一 一 一 猫 屎 咖啡 ， 就 是 用 广 香 猫 排泄 出 的 咖啡 豆 制造 
的 。 美 国 特种 咖啡 协会 称 “ 这 种 咖啡 味道 好 极 了 ”。 


这 些 特征 使 魔 香 猫 成 为 代表 并 发 和 多 线程 开发 的 完美 吉祥 物 。 软 件 开发 新 手 会 非常 讨厌 并 
发 和 多 线程 ， 它 们 会 让 原本 整洁 的 代码 变 得 乱七八糟 。 竞 态 条 件 (race condition) 和 其 他 莫 
名 其 妙 的 原因 会 导致 程序 严重 崩 江 (经 常 在 实际 产品 或 演示 程序 中 出 现 )。 有 些 人 其 至 声称 
“多 线程 是 魔鬼 ”， 并 且 完 全 不 使 用 并 发 编程 。 有 少数 开发 人 员 已 经 对 并 发 编程 产生 兴趣 ， 
并 毫 不 芋 惧 地 使 用 它 。 但 大 多 数 开发 人 员 曾 被 并 发 编程 摘 蛙 ， 并 且 留 下 了 不 好 的 印象 。 


然而 ， 并 发 性 正在 成 为 现代 程序 的 一 个 必 备 特性 。 今 天 的 软件 用 户 要 求 程序 界面 在 任何 时 
候 都 不 能 停止 响应 ， 另 外 ， 服 务 器 应 用 的 规模 变 得 越 来 越 大 。 并 发 编程 顺应 了 这 两 种 变化 
趋势 。 

幸好 ， 已 经 有 很 多 现代 的 程序 库 ， 使 并 发 编程 变 得 比 以 前 简单 多 了 ! 并 行 处 理 和 异步 开发 ， 
不 再 是 高 手 们 的 专利 。 这 些 程序 库 使 用 更 高 层次 的 抽象 化 ， 让 每 一 个 开发 人 员 都 能 开发 出 
具有 很 好 的 响应 性 和 可 扩展 性 的 程序 。 如 有 果 在 并 发 编程 还 非常 困难 的 时 候 你 曾经 感到 困惑 ， 
我 建议 你 用 现代 工具 重新 试 一 下 。 我 们 不 能 说 并 发 编程 很 容易 ， 但 确实 不 像 以 前 那么 难 了 。 


本 书 读者 对 象 


本 书面 向 希望 学 习 最 新 并 发 编程 方法 的 开发 人 员 。 你 需要 熟练 掌握 .NET 开发 ， 包 括 泛 型 
集合 (generic collection) 、 枚 举 (enumerable) 和 LINQ。 你 不 需要 具备 任何 多 线程 或 异步 
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开发 的 知识 。 本 书 介绍 新 的 、 更 安全 、 更 易 使 用 的 程序 库 ， 因 此 如 果 你 已 有 这 方面 的 经 
验 ， 读 这 本 书 也 会 有 所 帮助 。 


并 发 编程 适用 于 所 有 程序 。 不 管 是 桌面 程序 、 移 动 应 用 还 是 服务 器 应 用 ， 现 在 并 发 性 几乎 
是 所 有 程序 的 必 备 特性 。 利 用 本 书 提供 的 方法 ， 可 以 提高 用 户 界面 的 响应 速度 和 服务 器 应 
用 的 可 扩展 性 。 现 在 ， 并 发 编程 已 经 非常 普遍 ， 对 一 个 专业 开发 人 员 来 说 ， 掌 握 并 使 用 有 
关 技术 非常 必要 。 


本 书写 作 初 囊 


在 我 职业 生涯 的 早期 ， 我 费 了 很 大 力气 学 习 多 线程 开发 。 几 年 后 ， 我 又 费 了 很 大 力气 学 习 
异步 开发 。 尽 管 那些 经 验 很 有 价值 ， 但 我 仍然 很 希望 当时 就 能 有 今天 的 工具 和 资源 。 尤 其 
是 现在 的 .NET 语言 对 async 和 awailt 的 支持 ， 实 在 太 棒 了 。 



















































































然而 ， 现 在 大 多 数 介绍 并 发 编程 的 图 书 和 资料 都 是 从 最 底层 概念 开始 讲 起 。 那 些 书 用 大 量 
篇 幅 讲解 有 关 多 线程 和 序列 化 的 基本 概念 ， 并 且 把 较 高 级 的 技术 内 容 放 到 最 后 。 我 觉得 这 
么 做 的 原因 有 两 个 。 首 先 ， 很 多 像 我 这 样 的 并 发 编程 开发 人 员 确 实 是 从 底层 技术 学 起 ， 费 
劲 地 学 习 这 些 老 技 术 。 其 次 ， 很 多 书 是 多 年 前 出 版 的 ， 现 在 出 现 了 新 技术 ， 改 版 时 就 把 新 
技术 的 内 容 放 到 书 的 末尾 。 


我 觉得 那 种 做 法 有 些 落伍 。 本 书 只 介绍 进行 并 发 编程 的 最 新 方法 。 这 并 不 是 说 ， 理 解 全 部 
底层 概念 没 用 。 我 进入 大 学 学 习 编 程 时 ， 有 一 门 课程 需要 利用 少量 的 门 电路 来 组 建 一 个 虚 
拟 的 CPU， 另 一 门 课程 则 需要 用 汇编 语言 进行 开发 。 在 我 的 职业 生涯 里 ， 从 来 没有 设计 过 
CPU， 也 很 少 写 汇 编程 序 ， 但 是 理解 那些 基础 知识 对 我 的 日 常 工作 仍然 很 有 帮助 。 但 最 好 
是 从 更 高 级 的 抽象 概念 开始 学 习 ， 我 学 的 第 一 种 编程 语言 也 不 是 汇编 语言 。 

本 书 填补 了 一 项 市 场 空白 : 它 是 一 本 用 最 新 方法 进行 并 发 编程 的 入 门 指引 和 参考 书 。 本 书 
包含 了 儿 种 类 型 的 并 发 编程 ， 包 括 并 行 、 异 步 和 响应 式 编程 (reactive programming)。 至 于 
并 发 编程 的 老 技 术 ， 有 关 图 书 和 网 上 资料 有 很 多 ， 本 书 不 再 介绍 。 

































































1 入 


内 容 速 览 





本 书 既 是 一 本 入 门 指引 ， 也 是 一 本 快捷 参考 书 。 全 书 分 为 几 个 部 分 。 

。 第 1 章 ， 人 简要 介绍 本 书 涉及 的 儿 种 并 发 编程 类 型 并 行 、 异 步 、 响 应 式 编程 以 及 数 
据 流 。 

。 第 2 章 至 第 5 章 ， 更 详细 地 介绍 这 几 种 并 发 编程 类 型 。 

。 其 余 章 节 ， 分 别 讲 解 并 发 编程 的 各 个 方面 ， 也 可 作为 解决 常见 问题 时 的 参考 书 。 


即使 你 已 经 熟悉 某 些 类 型 的 并 发 编程 ， 建 议 你 还 是 要 读 第 1 章 ， 至 少 略 读 一 下 。 
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网 上 资料 
本 书 较 全 面 地 介绍 了 几 种 并 发 编程 类 型 ， 尽 可 能 包含 所 有 相关 知识 点 ， 但 不 管 怎样 ， 一 本 
书 无 法 包罗 万 象 。 si 推荐 学 习 下 面 的 资料 。 























并 行 编程 方面 ， 推 荐 阅读 Parallel Programming with Microsoft .NET (Microsoft Press) ， 英 
文 原 书 电子 版 可 以 从 网 上 下 载 。 可 惜 这 本 书 的 内 容 有 点 过 时 了 。 例 如 ，“future 模式 ”部 分 
应 该 改 用 异步 编程 , “流水线 ”(pipeline) 部 分 应 该 改 用 任务 TPL 数据 流 。 














异步 编程 方面 ， 推 荐 阅读 MSDN， 特 别 是 “Task-based Asynchronous Pattern” 这 篇 文档 。 











TPL 数据 流 方面 ， 推 荐 阅读 微软 发 布 的 “Introduction to TPL Dataflow” 文 档 。 


网 络 上 ， 响 应 式 扩 展 (Rx) 程序 库 越 来 越 流 行 了 ， 并 且 它 本 身 还 在 继续 发 展 。 在 我 看 来 ， 
学 习 Rx 最 好 的 资料 是 Lee Campbell 写 的 Introduction to Rx。 


排版 规范 


本 书 使 用 了 以 下 排版 规范 。 








0 或 者 段落 中 提 及 的 代码 元 素 (变量 名 、 函 数 名 、 数 据 库 、 数 据 类 
型 、 环 境 变量 、 程 序 语 句 、 关 键 字 )。 








表示 需要 用 户 逐 字 输 入 的 命令 或 者 其 他 文本 。 


. 等 宽 斜 体 
表示 需要 根据 用 户 提供 的 内 容 ， 或 者 根据 上 下 文 替换 掉 的 文字 。 


这 个 图 标 表 示 提 示 、 建 议 或 注解 。 


这 个 图 标 表 示警 告 或 提醒 。 








Safar 


Books Online 


o> Safari Books Online (http://www.safaribooksonline.com) 是 应 需 








© 
Safa 矿 上 而 变 的 数字 图 书馆 。 它 同时 以 图 书 和 视频 的 形式 出 版 世界 顶级 
Books Online ”技术 和 商务 作家 的 专业 作品 。 


Safari Books Online 是 技术 专家 、 软 件 开发 人 员 、Web 设计 师 、 商 务 人 士 和 创意 人 士 开 展 
调研 、 解 决 问题 、 学 习 和 认证 培训 的 第 一 手 资料 。 


对 于 组 织 


团体 、 政 府 机 构 和 个 人 ，Safari Books Online 提供 各 种 产品 组 合 和 灵活 的 定 





价 策略 。 用 户 可 通过 一 个 功能 完备 的 数据 库 检索 系统 访问 O’Reilly Media、Prentice 


Hall Professional、 Addison-Wesley Professional、 Microsoft Press、Sams、Que、Peachpit 





Press、 Focal Press、 Cisco Press、 John Wiley & Sons、 Syngress、 Morgan Kaufmann、IBM 


Redbooks 、 


Packt、Adobe Press、 FT Press、Apress、Manning、New Riders、McGraw-Hill、 








Jones 久 Bartlett、Course Technology 以 及 其 他 几 十 家 出 版 社 的 上 千 种 图 书 、 培 训 视 频 和 正 
式 出 版 之 前 的 书稿 。 要 了 解 Safari Books Online 的 更 多 信息 ， 我 们 网 上 见 。 


联系 我 们 


请 把 对 本 书 的 评价 和 问题 发 给 出 版 社 。 


美国 : 





O’Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 





中 国 


北京 市 西城 区 西直门 南大 街 2 号 成 铭 大 厦 C 座 807 室 (100035) 


奥 菜 利 技术 咨询 (北京 ) 有 限 公司 


O’Reilly 的 每 一 本 书 都 有 专属 网 页 ， 你 可 以 在 那儿 找到 本 书 的 相关 信息 ， 包 括 勘 误 表 、 示 
例 代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : 


























http://shop.oreilly.com/product/0636920030171.do 


对 于 本 书 的 评论 和 技术 性 问题 ， 请 发 送 电子 邮件 到 : 


bookquestions@oreilly.com 





要 了 解 更 多 O’Reilly 图 书 、 培 训 课程 、 会 议和 新 闻 的 信息 ， 请 访问 以 下 网 站 : 


http://www.oreilly.com 


我 们 在 Facebook 的 地 址 如 下 : http://facebook.com/oreilly 





请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia 


我 们 的 YouTube 视频 地 址 如 下 : http://www.youtube.com/oreillymedia 


致谢 


本 书 的 出 版 离 不 开 很 多 人 的 帮助 。 








首先 ， 我 要 感谢 上 帝 和 救世 主 耶 稣 基督 。 成 为 基督 徒 是 我 此 生 最 重要 的 决定 ! 如 果 你 想 了 


解 这 方面 的 更 多 信息 ， 欢 迎 通 过 我 的 个 人 网 站 (http: 
其 次 ， 我 要 感谢 我 的 家 人 ， 感 谢 他 们 容许 我 拿 出 那 








/stephencleary.com) 联系 我 。 


么 多 本 该 陪伴 他 们 的 时 间 写 书 。 开 始 





动笔 时 ， 有 从 事 写 作 的 朋友 告诉 我 :“ 你 将 有 一 年 的 时 间 无 法 陪伴 家 人 ! ”当时 我 还 以 为 
他 们 是 在 开玩笑 。 我 白天 工作 ， 晚 上 和 周末 用 来 写作 ， 对 此 我 的 妻子 Mandy、 孩 子 SD 和 


Emma 都 非常 理解 。 太 感谢 你 们 了 ， 我 爱 你 们 1! 








当然 ,下面 这 些 人 极 大 地 提高 了 本 书 质量 : 编辑 Brian MacDonald、 技 术 评 审 Stephen 
Toub、Petr Onderka (“svick”) 和 Nick Paldino (“casperOne”)。 如 果 书 中 有 错误 ， 那 侈 是 
他 们 的 责任 。 开 个 玩笑 ! 他 们 对 内 容 的 调整 和 修改 非常 有 价值 ， 如 果 书 中 还 有 错误 ， 当 然 


是 我 自己 的 责任 。 


最 后 ， 我 要 感谢 Stephen Toub、Lucian Wischik、Thomas Levesque 和 Lee Campbell， 我 是 


从 他 们 那里 学 到 的 有 关 技 术 。 他 们 是 Stack Overflow 


密 欣 根 州 及 周边 地 区 软件 研讨 会 的 参与 者 。 我 有 过 成 为 软件 开发 社区 的 一 员 ， 如 果 这 本 书 








具有 一 些 价值 ， 那 只 是 因为 那么 多 人 给 我 指明 方向 。 





和 MSDN 论坛 的 成 员 ， 也 是 我 的 家 乡 























感谢 大 家 |! 
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第 1 章 


并 发 编程 概述 





优秀 软件 的 一 个 关键 特征 就 是 具有 并 发 性 。 过 去 的 几 十 年 ， 我 们 可 以 进行 并 发 编程 ， 但 是 
难度 很 大 。 以 前 ， 并 发 性 软件 的 编写 、 调 试 和 维护 都 很 难 ， SS 
放弃 了 并 发 编程 。 新 版 .NET 中 的 程序 库 和 语言 特征 ， 已 经 让 并 发 编程 变 得 简单 多 了 。 随 
着 Visual Studio 2012 的 发 布 ， a E 做 并 发 
编程 ， 而 今天 ， 每 一 个 开发 人 员 都 能 够 (而 且 应 该 ) 接受 并 发 编程 。 


1.1 并 发 编程 简介 


首先 ， 我 来 解释 几 个 贯穿 本 书 始终 的 术语 。 先 来 介绍 并 





























。 并 发 
同时 做 多 件 事情 。 
这 个 解释 直接 表明 了 并 发 的 作用 。 终 端 用 户 程序 利用 并 发 功能 ， 在 输入 数据 库 的 同时 响应 


用 户 输入 。 服 务 器 应 用 利用 并 发 ， 在 处 理 第 一 个 请 求 的 同时 响应 第 二 个 请 求 。 只 要 你 希望 
程序 同时 做 多 件 事情 ， 你 就 需要 并 发 。 几 乎 每 个 软件 程序 都 会 受益 于 并 发 。 


在 编写 本 书 时 (2014 年 )， 大 多 数 开发 人 员 一 看 到 “并 发 ”就 会 想到 “多 线程 。 对 这 两 个 
概念 ， 需 要 做 一 下 区 分 




















。 多 线程 
并 发 的 一 种 形式 ， 它 采用 多 个 线程 来 执行 程序 。 


从 字面 上 看 ， 多 线程 就 是 使 用 多 个 线程 。 本 书后 续 章 节 将 介绍 ， 多 线程 是 并 发 的 一 种 形 
式 ， 但 不 是 唯一 的 形式 。 实 际 上 ， 直 接 使 用 底层 线程 类 型 在 现代 程序 中 基本 不 起 作用 。 比 
起 老式 的 多 线程 机 制 ， 采 用 高 级 的 抽象 机 制 会 让 程序 功能 更 加 强大 、 效 率 更 高 。 因 此 ， 本 
书 将 尽量 不 涉及 一 些 过 时 的 技术 。 书 中 所 有 多 线程 的 方法 都 采用 高 级 类 型 ， 而 不 是 Thread 


或 BackgroundWorker。 






































一 旦 你 输入 new Thread()， 那 就 糟糕 了 ， 说 明 项 目 中 的 代码 太 过 时 了 。 








但 是 ， 不 要 认为 多 线程 已 经 彻底 被 淘汰 了 ! 因为 线程 池 要 求 多 线程 继续 存在 。 线 程 池 存放 
任务 的 队列 ， 这 个 队列 能 够 根据 需要 自行 调整 。 相 应 地 ， 线 程 池 产 生 了 另 一 个 重要 的 并 发 
形式 : 并 行 处 理 。 
。 并 行 处 理 

把 正在 执行 的 大 量 的 任务 分 割 成 小 块 ， 分 配给 多 个 同时 运行 的 线程 。 
为 了 让 处 理 器 的 利用 效率 最 大 化 ， 并 行 处 理 (或 并 行 编程 ) 采用 多 线程 。 当 现代 多 核 CPU 
执行 大 量 任务 时 ， 若 只 用 一 个 核 执行 所 有 任务 ， 而 其 他 核 保持 空间 ， 这 显然 是 不 合理 的 。 
并 行 处 理 把 任务 分 割 成 小 块 并 分 配给 多 个 线程 ， 让 它们 在 不 同 的 核 上 独立 运行 。 


并 行 处 理 是 多 线程 的 一 种 ， 而 多 线程 是 并 发 的 一 种 。 在 现代 程序 中 ， 还 有 一 种 非常 重要 但 
很 多 人 还 不 熟悉 的 并 发 类 型 : 异步 编程 。 






































。 异步 编程 
并 发 的 一 种 形式 ， 它 采用 future 模式 或 回调 (callback) 机 制 ， 以 避免 产生 不 必要 的 
线程 。 


一 个 future (或 promise) 类 型 代表 一 些 即将 完成 的 操作 。 在 .NET 中 ， 新 版 future 类 型 
有 Task 和 Task<TResult>。 在 老式 异步 编程 API 中 ， 采 用 回调 或 事件 (event) ， 而 不 是 
future。 异 步 编程 的 核心 理念 是 异步 操作 : 启动 了 的 操作 将 会 在 一 段 时 间 后 完成 。 这 个 操作 
正在 执行 时 ， 不 会 阻塞 原来 的 线程 。 启 动 了 这 个 操作 的 线程 ， 可 以 继续 执行 其 他 任务 。 当 
操作 完成 时 ， 会 通知 它 的 future， 或 者 调用 回调 函数 ， 以 便 让 程序 知道 操作 已 经 结束 。 

















异步 编程 是 一 种 功能 强大 的 并 发 形式 ， 但 直至 不 久 前 ， 实 现 异 步 编 程 仍 需要 特别 复杂 的 代 
码 。VS2012 支持 async 和 await， 这 让 异步 编程 变 得 几乎 和 同步 〈 非 并 发 ) 编程 一 样 容 易 。 





并 发 编程 的 另 一 种 形式 是 响应 式 编程 (reactive programming)。 异 步 编程 意味 着 程序 启动 一 
个 操作 ， 而 该 操作 将 会 在 一 段 时 间 后 完成 。 响 应 式 编 程 与 异步 编程 非常 类 似 ， 不 过 它 是 基 
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于 异步 事件 (asynchronous event) 的 ， 而 不 是 异步 操作 (asynchronous operation)。 异 步 事 件 
可 以 没有 一 个 实际 的 “开始 "， 可 以 在 任何 时 间 发 生 ， 并 且 可 以 发 生 多 次 ， 例 如 用 户 输入 。 


。 响应 式 编程 
一 种 声明 式 的 编程 模式 ， 程 序 在 该 模式 中 对 事件 做 出 响应 。 


如 果 把 一 个 程序 看 作 一 个 大 型 的 状态 机 ， 则 该 程序 的 行为 便 可 视 为 它 对 一 系列 事件 做 出 响 
应 ， 即 每 换 一 个 事件 ， 它 就 更 新 一 次 自己 的 状态 。 这 听 起 来 很 抽象 和 空洞 ， Ce 
如 此 。 利 用 现代 的 程序 框架 ， 响 应 式 编 程 已 经 在 实际 开发 中 广泛 使 用 。 响 应 式 编程 不 一 
是 并 发 的 ， 但 它 与 并 发 编程 联系 紧密 ， 因 此 本 书 介绍 了 响应 式 编程 的 基础 知识 。 


通常 情况 下 ， 一 个 并 发 程序 要 使 用 多 种 技术 。 大 多 数 程序 至 少 使 用 了 多 线程 《通过 线程 
池 ) 和 异步 编程 。 要 大 胆 地 把 各 种 并 发 编程 形式 进行 混合 和 匹配 ， 在 程序 的 各 个 部 分 使 用 
合适 的 工具 。 





























1.2 ”异步 编程 简介 

异步 编程 有 两 大 好 处 。 第 一 个 好 处 是 对 于 面向 终端 用 户 的 GUI 程序 : 异步 编程 提高 了 响应 
能 力 。 我 们 都 遇 到 过 在 运行 时 会 临时 锁定 界面 的 程序 ， 异 步 编程 可 以 使 程序 在 执行 任务 时 

仍 能 响应 用 户 的 输入 。 第 二 个 好 处 是 对 于 服务 器 端 应 用 : 异步 编程 实现 了 可 扩展 性 。 服 务 

器 应 用 可 以 利用 线程 池 满 足 其 可 扩展 性 ， 使 用 异步 编程 后 ， 可 扩展 性 通常 可 以 提高 一 个 数 

量 级 。 




















现代 的 异步 .NET 程序 使 用 两 个 关键 字 : async 和 await。async 关键 字 加 在 方法 声明 上 ， 
它 的 主要 目的 是 使 方法 内 的 await 关键 字 生 效 (为 了 保持 向 后 兼容 ， 同 时 引入 了 这 两 个 关 
键 字 )。 如 果 async 方法 有 返回 值 ， 应 返回 Task<T>;， 如 果 没 有 返回 值 ， 应 返回 Task。 这 些 
task 类 型 相当 于 future， 用 来 在 异步 方法 结束 时 通知 主 程序 。 


不 要 用 void 作为 async 方法 的 返回 类 型 ! async 方法 可 以 返回 void, 但 是 这 
仅 限于 编写 事件 处 理 程序 。 一 个 普通 的 async 方法 如 果 没 有 返回 值 ， 要 返回 


Task， 而 不 是 void。 



















































































有 了 上 述 背 景 知识 ， 我 们 来 快速 看 一 个 例子 


async Task DoSomethingAsync() 
{ 


nt val .133 


// 异步 方式 等 待 1 秒 
await Task.Delay(TimeSpan.FromSeconds(1)); 





val *= 2; 
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// 异步 方式 等 待 1 秒 
await Task.Delay(TimeSpan.FromSeconds(1)); 


Trace.WriteLine(val); 


3 


和 其 他 方法 一 样 ，async 方法 在 开始 时 以 同步 方式 执行 。 在 async 方法 内 部 ，await 关键 字 
对 它 的 参数 执行 一 个 异步 等 待 。 它 首先 检查 操作 是 否 已 经 完成 ， 如 果 完 成 了 ， 就 继续 运行 
(同步 方式 )。 否 则 ， 它 会 暂停 async 方法 ， 并 返回 ， 留 下 一 个 未 完成 的 task。 一 段 时 间 后 ， 
操作 完成 ，async 方法 就 恢复 运行 。 


一 个 async 方法 是 由 多 个 同步 执行 的 程序 块 组 成 的 ， 每 个 同步 程序 块 之 间 由 await 语句 分 
隔 。 第 一 个 同步 程序 块 在 调用 这 个 方法 的 线程 中 运行 ， 但 其 他 同步 程序 块 在 哪里 运行 呢 ? 
情况 比较 复杂 。 

















最 常见 的 情况 是 ， 用 await 语句 等 待 一 个 任务 完成 ， 当 该 方法 在 await 处 暂停 时 ， 就 可 以 
捕 扣 上下文 (context)。 如 果 当 前 SynchronizationContext 不 为 空 ， 这 个 上 下 文 就 是 当前 
SynchronizationContext。 如 果 当 前 SynchronizationContext 为 空 ， 则 这 个 上 下 文 为 当前 
TaskscheduLer。 该 方法 会 在 这 个 上 下 文中 继续 运行 。 一 般 来 说 ， 运 行 UI 线程 时 采用 UI 上 
下 文 ， 处 理 ASP.NET 请 求 时 采用 ASP.NET 请 求 上 下 文 ， 其 他 很 多 情况 下 则 采用 线程 池上 
下 文 。 


因此 ， 在 上 面 的 代码 中 ， 每 个 同步 程序 块 会 试图 在 原始 的 上 下 文中 恢复 运行 。 如 有 果 在 UI 
线程 中 调用 DoSomethingAsync， 这 个 方法 的 每 个 同步 程序 块 都 将 在 此 UI 线程 上 运行 。 但 
是 ， 如 果 在 线程 池 线 程 中 调用 ， 每 个 同步 程序 块 将 在 线程 池 线 程 上 运行 。 


要 避免 这 种 错误 行为 ， 可 以 在 await 中 使 用 ConfigureAwait 方法 ， 将 参数 continueOn 
CapturedContext 设 为 false。 接 下 来 的 代码 刚 开始 会 在 调用 的 线程 里 运行 ， 在 被 await 暂 
停 后 ， 则 会 在 线程 池 线 程 里 继续 运行 : 



























































async Task DoSomethingAsync() 
‘ 


int val = 13; 


// 异步 方式 等 待 1 秒 


await Task.Delay(TimeSpan.FromSeconds(1)).ConfigureAwait(false); 





val *= 2; 


// 异步 方式 等 待 1 秒 


await Task.Delay(TimeSpan.FromSeconds(1)).ConfigureAwait(false); 





Trace.WriteLine(val.ToString()); 





最 好 的 做 法 是 ， 在 核心 库 代 码 中 一 直 使 用 ConfigureAwait。 在 外 围 的 用 户 界 
面 代 码 中 ， 只 在 需要 时 才 恢 复 上 下 文 


























关键 字 avatt 不 仅 能 用 于 任务 ， 还 能 用 于 所 有 遵循 特定 模式 的 awaitable 类 型 。 例 如 ， 
Windows Runtime API 定义 了 自己 专用 的 异步 操作 接口 。 这 些 接口 不 能 转化 为 Task 类 型 ， 
但 确实 遵循 了 可 等 待 的 (awaitable) 模式 ， 因 此 可 以 直接 使 用 await。 这 种 awaitable 类 型 
在 Windows 应 用 商店 程序 中 更 加 常见 ， 但 是 在 大 多 数 情 况 下 ，await 使 用 Task 或 Task<T>。 


有 两 种 基本 的 方法 可 以 创建 Task 实例 。 有 些 任务 表示 CPU 需要 实际 执行 的 指令 ， 创 建 
这 种 计算 类 的 任务 时 ， 使 用 Task.Run (如 需要 按照 特定 的 计划 运行 ， 则 用 TaskFactory. 
StartNew)。 其 他 的 任务 表示 一 个 通知 (notification)， 创 建 这 种 基于 事件 的 任务 时 ， 使 用 
TaskCompletionSource<T>。 大 部 分 1/O 型 任务 采用 TaskCompletionSource<T>。 

















使 用 async 和 await 上 时， 自然 要 处 理 错误 。 在 下 面 的 代码 中 ，PossibleExceptionAsync 会 
抛 出 一 个 NotSupportedException 异常 ， 而 TrySomethingAsync 方法 可 很 顺利 地 捕捉 到 这 个 
异常 。 这 个 捕捉 到 的 异常 完整 地 保留 了 栈 轨 迹 ， 没 有 人 为 地 将 它 封 装 进 TargetInvocation 
Exception 或 AggregateException 类 : 














async Task TrySomethingAsync() 


{ 
try 
{ 
await PossibleExceptionAsync(); 
catch(NotSupportedException ex) 
{ 
LogException(ex); 
throw; 
} 
} 


一 旦 异步 方法 抛 出 (或 传递 出 ) 异常 ， 该 异常 会 放 在 返回 的 Task 对 象 中 ， 并 且 这 个 Task 
对 象 的 状态 变 为 “已 完成 "。 当 await 调用 该 Task 对 象 时 ，await 会 获得 并 (重新 ) 抛 出 该 
异常 ， 并 且 保 留 着 原始 的 栈 轨 迹 。 因 此 ， 如 果 PossibleExceptionAsync 是 异步 方法 ， 以 下 
代码 就 能 正常 运行 : 





async Task TrySomethingAsync() 


{ 
// 发 生 异 常 时 ， 任 务 结束 。 不 会 直接 抛 出 异常 。 


Task task = PossibleExceptionAsync(); 








try 


//Task 对 象 中 的 异常 ， 会 在 这 条 await 语句 中 引发 
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await task; 


catch(NotSupportedException ex) 
{ 
LogException(ex); 
throw; 
} 
} 


关于 异步 方法 ， 还 有 一 条 重要 的 准则 : 你 一 旦 在 代码 中 使 用 了 异步 ， 最 好 一 直 使 用 。 调 用 
异步 方法 时 ， 应 该 (在 调用 结束 时 ) 用 await 等 待 它 返 回 的 task 对 象 。 一 定 要 避免 使 用 
Task.Wait 或 Task<T>.Result 方法 ， 因 为 它们 会 导致 死 锁 。 参 考 一 下 下 面 这 个 方法 : 




















async Task WaitAsync() 





// 这 里 awati 会 捕获 当前 上 下 文 …… 
await Task.Delay(TimeSpan.FromSeconds(1)); 
1/ …… 这 里 会 试图 用 上 面 捕获 的 上 下 文 继续 执行 


























4 
void Deadlock() 
{ 
// 开始 延迟 
Task task = WaitAsync(); 
// 同步 程序 块 ， 正 在 等 待 异 步 方 法 完成 
task.Wait(); 
} 


如 果 从 UI 或 ASP.NET 的 上 下 文 调用 这 段 代 码 ， 就 会 发 生死 锁 。 这 是 因为 ， 这 两 种 上 下 
文 每 次 只 能 运行 一 个 线程 。Deadlock 方法 调用 WaitAsync 方法 ，WaitAsync 方法 开始 调用 
delay 语句 。 然 后 ，Deadlock 方法 (同步 ) 等 待 WaitAsync 方法 完成 ， 同 时 阻塞 了 上 下 文 线 
程 。 当 delay 语句 结束 时 ，await 试图 在 已 捕获 的 上 下 文中 继续 运行 WaitAsync 方法 ， 但 这 
个 步骤 无 法 成 功 ， 因 为 上 下 文中 已 经 有 了 一 个 阻塞 的 线程 ， 并 且 这 种 上 下 文 只 允许 同时 运 
行 一 个 线程 。 这 里 有 两 个 方法 可 以 避免 死 锁 : 在 WaitAsync 中 使 用 ConfigureAwait(false) 
(导致 await 忽略 该 方法 的 上 下 文 )， 或 者 用 await 语句 调用 WaitAsync 方法 (让 Deadlock 
变 成 一 个 异步 方法 )。 


俱 、 如 果 使 用 了 async， 最 好 就 一 直 使 用 它 。 


若 想 更 全 面 地 了 解 关 于 异步 编程 的 知识 ， 可 参阅 Alex Davies (O'"Reilly) 编写 的 Async in 
C# 50， 这 本 书 非 常 不 错 。 另 外 ， 微 软 公司 有 关 异 步 编程 的 在 线 文档 也 很 不 错 ， 建 议 你 至 
少 读 一 读 “async overview” 和 “Task-based Asynchronous Pattern(TAP) overview” 这 两 篇 。 


如 果 要 深入 了 解 ， 官 方 FAQ 和 博客 上 也 有 大 量 的 信息 。 
































A 
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1.3 ”并行 编程 简介 

如 果 程 序 中 有 大 量 的 计算 任务 ， 并 且 这 些 任务 能 分 割 成 几 个 互相 独立 的 任务 块 ， 那 就 应 
该 使 用 并 行 编程 。 并 行 编程 可 临时 提高 CPU 利用 率 ， 以 提高 吞吐 量 ， 若 客户 端 系统 中 的 
CPU 经 常 处 于 空闲 状态 ， 这 个 方法 就 非常 有 用 ， 但 通常 并 不 适合 服务 器 系统 。 大 多 数 服 
务 器 本 身 具 有 并 行 处 理 能 力 ， 例 如 ASP.NET 可 并 行 地 处 理 多 个 请 求 。 某 些 情况 下 ， 在 服 
务 器 系统 中 编写 并 行 代码 仍然 有 用 (如果 你 知道 并 发 用 户 数 量 会 一 直 是 少数 )。 但 通常 情 
况 下 ， 在 服务 器 系统 上 进行 并 行 编程 ， 将 降低 本 身 的 并 行 处 理 能 力 ， 并 且 不 会 有 实际 的 
好 处 。 


























并 行 的 形式 有 两 种 : 数据 并 行 (data parallelism) 和 任务 并 行 (task parallelim)。 数 据 并 行 
是 指 有 大 量 的 数据 需要 处 理 ， 并 且 每 一 块 数据 的 处 理 过 程 基本 上 是 彼此 独立 的 。 任 务 并 行 
是 指 需要 执行 大 量 任务 ， 并 且 每 个 任务 的 执行 过 程 基 本 上 是 彼此 独立 的 。 任 务 并 行 可 以 
是 动态 的 ， 如 果 一 个 任务 的 执行 结果 会 产生 额外 的 任务 ， 这 些 新 增 的 任务 也 可 以 加 入 任 


务 池 。 



































实现 数据 并 行 有 儿 种 不 同 的 做 法 。 一 种 做 法 是 使 用 Parallel.ForEach 方法 ， 它 类 似 于 
foreach 循环 ， 应 尽 可 能 使 用 这 种 做 法 。 在 3.1 节 将 会 详细 介绍 Paratlel.ForEach 方 法。 
Parallel 类 也 提供 Parallel.For 方法 ， 这 类 似 于 for 循环 ， 当 数据 处 理 过 程 基于 一 个 索引 
时 ， 可 使 用 这 个 方法 。 下 面 是 使 用 Paratlel.ForEach 的 代码 例子 : 


void RotateMatrices(IEnumerable<Matrix> matrices, float degrees) 


{ 


Parallel.ForEach(matrices, matrix => matrix.Rotate(degrees)); 


另 一 种 做 法 是 使 用 PLINQ (Parallel LINQ) , 它 为 LINQ 查询 提供 了 AsParallel 扩展 。 跟 
PLINQ 相 比 ，Parallel 对 资源 更 加 友好 ，Parallel 与 系统 中 的 其 他 进程 配合 得 比较 好 ,而 
PLINQ 会 试图 让 所 有 的 CPU 来 执行 本 进程 。Parallel 的 缺点 是 它 太 明显 。 很 多 情况 下 ， 
PLINQ 的 代码 更 加 优美 。PLINQ 在 3.5 节 有 详细 介绍 : 





IEnumerable<bool> PrimalityTest(IEnumerable<int> values) 


{ 


return values.AsParallel().Select(val => IsPrime(val)); 


} 
不 管 选用 哪 种 方法 ， 在 并 行 处 理 时 有 一 个 非常 重要 的 准则 。 





每 个 任务 块 要 尽 可 能 的 互相 独立 。 
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只 要 任务 块 是 互相 独立 的 ， 并 行 性 就 能 做 到 最 大 化 。 一 旦 你 在 多 个 线程 中 共享 状态 ， 就 必 
须 以 同步 方式 访问 这 些 状态 ， 那 样 程序 的 并 行 性 就 变 差 了 。 第 11 章 将 详细 讲述 同步 。 
























































有 多 种 方式 可 以 控制 并 行 处 理 的 输出 。 可 以 把 结果 存在 某 些 并 发 集合 ， 或 者 对 结果 进行 聚 
合 。 聚 合 在 并 行 处 理 中 很 常见 ，Parallel 类 的 重 载 方法 ， 也 支持 这 种 map/reduce 国 数 。 关 





于 聚合 的 详细 内 容 在 3.2 市 。 








下 面 讲 任务 并 行 。 数 据 并 行 重点 在 处 理 数据 ， 任 务 并 行 则 关注 执行 任务 。 




















Parallel 类 的 ParatLtetL.Invoke 方法 可 以 执行 “分 又 /联合 ”(forlvjoin) 方式 的 任务 并 行 。 
3.3 节 将 详细 介绍 这 个 方法 。 调 用 该 方法 时 ， 把 要 并 行 执行 的 委托 (delegate) 作为 传 入 
参数 : 








void ProcessArray(double[] array) 


{ 
Parallel.Invoke(l 
() => ProcessPartialArray(array, 0, array.Length / 2)， 
() => ProcessPartialArray(array, array.Length / 2, array.Length) 
3 
} 


void ProcessPartialArray(double[] array, int begin, int end) 


， A/ PU 密集 型 的 要 作 …… 

现在 Task 这 个 类 也 被 用 于 异步 编程 ， 但 当初 它 是 为 了 任务 并 行 而 引入 的 。 任 务 并 行 中 使 
用 的 一 个 Task 实例 表示 一 些 任务 。 可 以 使 用 Wait 方法 等 待 任务 完成 ， 还 可 以 使 用 Result 
和 Exception 属性 来 检查 任务 执行 的 结果 。 直 接 使 用 Task 类 型 的 代码 比 使 用 Parallel 类 
要 复杂 ， 但 是 ， 如 果 在 运行 前 不 知道 并 行 任务 的 结构 ， 就 需要 使 用 Task 类 型 。 如 果 使 
用 动态 并 行 机 制 ， 在 开始 处 理 时 ， 任 务 块 的 个 数 是 不 确定 的 ， 只 有 继续 执行 后 才能 确 
定 。 通 常情 况 下 ， 一 个 动态 任务 块 要 局 动 它 所 需 的 所 有 子 任务 ， 然 后 等 待 这些 子 任务 执 
行 完毕 。 为 实现 这 个 功能 ， 可 以 使 用 Task 类 型 中 的 一 个 特殊 标志 : TaskCreation0ptions . 
AttachedToParent。 动 态 并 行 机 制 在 3.4 节 中 详 述 。 


跟 数据 并 行 一 样 ， 任 务 并 行 也 强调 任务 块 的 独立 性 。 委 托 (delegate) 的 独立 性 越 强 ， 程 序 
的 执行 效率 就 越 高 。 在 编写 任务 并 行程 序 时 ， 要 格外 留意 下 闭 包 (closure) 捕获 的 变量 。 
记 住 闭 包 捕 获 的 是 引用 (不 是 值 )， 因 此 可 以 在 结束 时 以 不 明显 地 方式 地 分 享 这 些 变 量 。 











































































































对 所 有 并 行 处 理 类 型 来 讲 ， 错 误 处 理 的 方法 都 差不多 。 由 于 操作 是 并 行 执行 的 ， 多 个 异常 
就 会 同时 发 生 ， 系 统 会 把 这 些 异 常 封装 在 AggregateException 类 里 ， 在 程序 中 抛 给 代码 。 
这 一 特点 对 所 有 方法 都 是 一 样 的 ， 包 括 Parallel.ForEach、Paralle.lInvoke、Task.Wait 等 。 
AggregateException 类 型 有 儿 个 实用 的 Flatten 和 Handle 方法 ， 用 来 简化 错误 处 理 的 代码 : 
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try 


Parallel.Invoke(() => { throw new Exception(); }， 
() => { throw new Exception(); }); 


catch (AggregateException ex) 


ex.Handle(exception => 
‘ 
Trace.WriteLine(exception); 
return true; // “已 经 处 理 ” 
]); 





} 


通常 情况 下 ， 没 必要 关心 线程 池 处 理 任 务 的 具体 做 法 。 数 据 并行 和 任务 并 行 都 使 用 动态 调 
整 的 分 割 器 ， 把 任务 分 割 后 分 配给 工作 线程 。 线 程 池 在 需要 的 时 候 会 增加 线程 数量 。 线 程 
池 线 程 使 用 工作 窍 取 队列 (work-stealing queue)。 微 软 公 司 为 了 让 每 个 部 分 尽 可 能 高 效 ， 
做 了 很 多 优化 。 要 让 程序 得 到 最 佳 的 性 能 ， 有 很 多 参数 可 以 调节 。 只 要 任务 时 长 不 是 特别 
短 ， 采 用 默认 设置 就 会 运行 得 很 好 。 





























任务 不 要 特别 短 ， 也 不 要 特别 长 。 




















如 果 任 务 太 得， 把 数据 分 割 进 任务 和 在 线程 地 中 调度 任务 的 开销 会 很 大 。 如 果 任 务 太 长 ， 
线程 池 就 不 能 进行 有 效 的 动态 调整 以 达到 工作 量 的 平衡 。 很 难 确 定 “ 太 短 ” 和 “ 太 长 ”的 
判断 标准 ， 这 取决 于 程序 所 解决 问题 的 类 型 以 及 硬件 的 性 能 。 根 据 一 个 通用 的 准则 ， 只 

没有 导致 性 能 问题 ， 我 会 让 任务 尽 可 能 短 (如 果 任 务 太 短 ， 程 序 性 能 会 突然 降低 )。 更 好 
的 做 法 是 使 用 Paratlel 类 型 或 者 PLINQ， 而 不 是 直接 使 用 任务 。 这 些 并 行 处 理 的 高 级 形 
式 ， 自 带 有 自动 分 配 任务 的 算法 (并且 会 在 运行 时 自动 调整 )。 


























要 更 深入 的 了 解 并 行 编程 ， 这 方面 最 好 的 书 是 Colin Campbell 等 人 编写 的 Parallel Programming 
with Microso 丰 NET (微软 出 版 社 ) 。 


1.4 响应 式 编 程 简介 


跟 并 发 编程 的 其 他 形式 相 比 ， 响 应 式 编 程 的 学 习 难 度 较 大 。 如 有 果 对 响应 式 编 程 不 是 非常 熟 
悉 ， 代 码 维护 相对 会 更 难 一 点 。 一 旦 你 学 会 了 ， 就 会 发 现 响 应 式 编程 的 功能 特别 强大 。 响 
应 式 编 程 可 以 像 处 理 数 据 流 一 样 处 理事 件 流 。 根 据 经 验 ， 如 果 事 件 中 带 有 参数 ， 那 么 最 好 
采用 响应 式 编程 ， 而 不 是 常规 的 事件 处 理 程序 。 







































































响应 式 编程 基于 “可 观察 的 流 ”(observable stream) 这 一 概念 。 你 一 旦 申请 了 可 观察 流 ， 就 
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可 以 收 到 任意 数量 的 数据 项 (onNext)， 并 且 流 在 结束 时 会 发 出 一 个 错误 (OnError) 或 一 个 
“ 流 结束 ”的 通知 (0nCompleted)。 有 些 可 观察 流 是 不 会 结束 的 。 实 际 的 接口 就 像 这 样 : 











interface IObserver<in T> 


{ 
void OnNext(T item); 
void OnCompleted(); 
void OnError(Exception error); 
} 
interface IObservable<out T> 
{ 
IDisposable Subscribe(IObserver<T> observer); 
} 


不 过 ， 开 发 人 员 不 需要 实现 这 些 接 口 。 微 软 的 Reactive Extensions (Rx) 库 已 经 实现 了 所 
有 接口 。 响 应 式 编 程 的 最 终 代码 非常 像 LINQ， 可 以 认为 它 就 是 “LINQ to events"。 下 面 
的 代码 中 ， 前 面 是 我 们 不 熟悉 的 操作 符 (Interval 和 Timestamp)， 最 后 是 一 个 Subscribe， 
但 是 中 间 部 分 是 我 们 在 LINQ 中 熟悉 的 操作 符 : Where 和 Select。LINQ 具有 的 特性 ，Rx 
也 都 有 。Rx 在 此 基础 上 增加 了 很 多 它 自 己 的 操作 符 ， 特 别 是 与 时 间 有 关 的 操作 符 : 





Observable.Interval(TimeSpan.FromSeconds(1)) 
.Timestamp() 
.Where(x => x.Value % 2 == 0) 
.Select(x => x.Timestamp) 
.Subscribe(x => Trace.WriteLine(x)); 





上 面 的 代码 中 ， 首 先是 一 个 延 时 一 段 时 间 的 计数 器 (Interval)， 随 后 、 后 为 每 个 事件 加 
了 一 个 时 间 惟 (Timestamp)。 接 着 对 事件 进行 过 滤 ， 只 包含 偶数 值 (where)， 选 择 了 时 间 
戳 的 值 (Timestamp) ， 然 后 当 每 个 时 间 戳 值 到 达 时 ， 把 它 输入 调试 器 (Subscribe)。 如 果 
没有 理解 上 述 新 的 操作 符 (例如 Interval)， 不 要 紧 ， 我 们 会 在 后 面 讲述 。 现 在 只 要 记 住 
这 是 一 个 LINQ 查询 ， 与 你 以 前 见 过 的 LINQ 查询 很 类 似 。 主 要 区 别 在 于 : LINQ to Object 
和 LINQ to Entity 使 用 “ 拉 取 ”模式 ，LINQ 的 枚 举 通过 查询 拉 出 数据 。 而 LINQ to event 
(Rx) 使 用 “推送 ”模式 ， 事 件 到 达 后 就 自行 穿 过 查询 。 



























































可 观察 流 的 定义 和 其 订阅 是 互相 独立 的 。 上 面 最 后 一 个 例子 与 下 面 的 代码 等 效 : 














IObservabLe<DateTimeOffset> timestamps = 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.Timestamp() 

.Where(x => x.Value % 2 == 0) 
.Select(x => x.Timestamp); 
timestamps.Subscribe(x => Trace.WriteLine(x)); 


一 种 常规 的 做 法 是 把 可 观察 流 定 义 为 一 种 类 型 ， 然 后 将 其 作为 IObservable<T> 资源 使 用 。 
其 他 类 型 可 以 订阅 这 些 流 ， 或 者 把 这 些 流 与 其 他 操作 符 组 合 ， 创 建 男 一 个 可 观察 流 。 








Rx 的 订阅 也 是 一 个 资源 。Subscribe 操作 符 返 回 一 个 IDisposable， 即 表示 订阅 完成 。 当 你 
响应 了 那个 可 观察 流 ， 就 得 处 理 这 个 订阅 。 





对 于 hot observable ( 热 可 观察 流 ) 和 cold observable ( 冷 可 观察 流 ) 这 两 种 对 象 ， 订 阅 的 做 
法 各 有 不 同 。 一 个 hot observable 对 象 是 指 一 直 在 发 生 的 事件 流 ， 如 果 在 事件 到 达 时 没有 订 
阅 者 ， 事 件 就 丢失 了 。 例 如 ， 鼠 标的 移动 就 是 一 个 hot observable 对 象 。old observable 对 象 是 
始终 没有 输入 事件 〈 不 会 主动 产生 事件 ) 的 观察 流 ， 它 只 会 通过 启动 一 个 事件 队列 来 响应 订 
阅 。 例 如 ，HTTP 下 载 是 一 个 cold observable 对 象 ， 只 有 在 订阅 后 才 会 发 出 HTTP 请 求 。 






































同样 ， 所 有 Subscribe 操作 符 都 需要 有 处 理 错误 的 参数 。 前 面 的 例子 没有 错误 处 理 参 数 。 
下 面 则 是 一 个 更 好 的 例子 ， 在 可 观察 流 发 生 错 误 时 ， 它 能 正确 处 理 : 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.Timestamp() 
.Where(x => x.Value % 2 == 0) 
.Select(x => x.Timestamp) 


.Subscribe(x => Trace.WriteLine(x), 
ex => Trace.WriteLine(ex)); 


在 进行 Rx 实验 性 编程 时 ，Subject<T> 这 个 类 型 很 有 用 。 这 个 “subject” 就 像 手动 实现 一 
个 可 观察 流 。 可 以 在 代码 中 调用 OnNext、OnError 和 0nCompLeted， 这 个 subject 会 把 这 些 
调用 传递 给 订阅 者 。Subject<T> 用 于 实验 时 效果 非常 不 错 ， 但 在 实际 产品 开发 时 ， 应 该 使 
用 第 5 章 介 绍 的 操作 符 。 


Rx 的 操作 符 非常 多 ， 本 书 只 介绍 了 一 部 分 。 想 了 解 关于 Rx 的 更 多 信息 ， 建 议 阅读 优秀 的 
在 线 图 书 Introduction to Rx。 


1.5 数据 流 简介 

TPL 数据 流 很 有 意思 ， 它 把 异步 编程 和 并 行 编程 这 两 种 技术 结合 起 来 。 如 果 需 要 对 数据 进 
行 一 连 串 的 处 理 ，TPL 数据 流 就 很 有 有用。 例如， 需要 从 一 个 URL 上 下 载 数据 ， 接 着 解析 
数据 ， 然 后 把 它 与 其 他 数据 一 起 做 并 行 处 理 。TPL 数据 流通 常 作为 一 个 简易 的 管道 ， 数 据 
从 管道 的 一 端 进 入 ， 在 管道 中 穿行 ， 最 后 从 另 一 端 出 来 。 不 过 ，TPL 数据 流 的 功能 比 普 
通 管 道 要 强大 多 了 。 对 于 处 理 各 种 类 型 的 网 格 (mesh)， 在 网 格 中 定义 分 又 (fork)、 连 接 
(join)、 循 环 (loop) 的 工作 ，TPL 数据 流 都 能 正确 地 处 理 。 当 然 了 ， 大 多 数 时 候 TPL 数 
据 流 网 格 还 是 被 用 作 管道 。 


























数据 流 网 格 的 基本 组 成 单元 是 数据 流 块 (dataflow block)。 数 据 流 块 可 以 是 目标 块 (接收 
数据 ) 或 源 块 (生成 数据 )， 或 两 者 丝 可 。 源 块 可 以 连接 到 目标 块 ， 创 建 网 格 。 连 接 的 具 
体内 容 在 4.1 节 介 绍 。 数 据 流 块 是 半 独 立 的 ， 当 数据 到 达 时 ， 数 据 流 块 会 试图 对 数据 进行 
处 理 ， 并 且 把 处 理 结果 推送 给 下 一 个 流程 。 使 用 TPL 数据 流 的 常规 方法 是 创建 所 有 的 块 ， 
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再 把 它们 链接 起 来 ， 然 后 开始 在 一 端 填 和 数据。 然后， 数据 会 自行 从 另 一 端 出 来 。 再 强调 
一 次 ， 数 据 流 的 功能 比 这 要 强大 得 多 ， 数 据 穿 过 的 同时 ， 可 能 会 断 开 连 接 、 创 建新 的 块 并 
加 入 到 网 格 ， 不 过 这 是 非常 高 级 的 使 用 场景 。 

















目标 块 带 有 缓冲 区 ， 用 来 存放 收 到 的 数据 。 因 此 ， 在 还 来 不 及 处 理 数据 的 时 候 ， 它 仍 能 提 
收 新 的 数据 项 ， 这 就 让 数据 可 以 持续 地 在 网 格 上 流动 。 在 有 分 又 的 情况 下 ， 一 个 源 块 链接 
了 两 个 目标 块 ， 这 种 缓冲 机 制 就 会 产生 问题 。 当 源 块 有 数据 需要 传递 下 去 时 ， 它 会 把 数据 
传 给 与 它 链接 的 块 ， 并且 一 次 只 传 一 个 数据 。 默 认 情况 下 ， 第 一 个 目标 块 会 接收 数据 并 组 
存 起 来 ， 而 第 二 个 目标 块 就 收 不 到 任何 数据 。 解 决 这 个 问题 的 方法 是 把 目标 块 设 置 为 “ 非 
仿 禁 ”模式 ， 以 限制 缓冲 区 的 数量 ， 这 部 分 将 在 4.4 市 介绍 。 


如 果 某 些 步 又 出 错 ， 例 如 委托 在 处 理 数 据 项 时 抛 出 异常 ， 数 据 流 块 就 会 出 错 。 数 据 流 块 出 
错 后 就 会 停止 接收 数据 。 上 默认 情况 下 ， 一 个 块 出 错 不 会 摧毁 整个 网 格 。 这 让 程序 有 能 力 重 
建部 分 网 格 ， 或 者 对 数据 重新 定向 。 然 而 这 是 一 个 高 级 用 法 。 通 常 来 讲 ， 你 是 希望 这 些 错 
误 通过 链接 传递 给 目标 块 。 数 据 流 也 提供 这 个 选择 ， 唯 一 比较 难 办 的 地 方 是 当 异 常 通过 链 
接 传递 时 ， 它 就 会 被 封装 在 AggregateException 类 中 。 因 此 ， 如 果 管 道 很 长 ， 最 后 异常 的 
嵌 套 层次 会 非常 多 ， 这 时 就 可 以 使 用 AggregateException.Flatten 方法 : 









































try 
{ 


var multiplyBlock = new TransformBlock<int, int>(item => 


if (item == 1) 
throw new InvalidOperationException("Blech."); 
return item * 2; 
}); 
var subtractBlock = new TransformBlock<int, int>(item => item - 2); 
multiplyBlock.LinkTo(subtractBlock, 
new DataflowLinkOptions { PropagateCompletion = true }); 


multiplyBlock.Post(1); 
subtractBlock.Completion.Wait(); 
} 


catch (AggregateException exception) 


AggregateException ex = exception.Flatten(); 
Trace.WriteLine(ex.InnerException); 


3 
数据 流 错误 的 处 理 方法 将 在 4.2 市 详细 介绍 。 
数据 流 网 格 给 人 的 第 一 印象 是 与 可 观察 流 非 常 类 似 ， 实 际 上 它们 确实 有 很 多 共同 点 。 网 格 
和 流 都 有 “数据 项 ”这 一 概念 ， 数 据 项 从 网 格 或 流 的 中 间 罕 过 。 还 有 ， 网 格 和 流 都 有 “ 正 


常 完成 ”( 表 示 没 有 更 多 数据 需要 接收 时 发 出 的 通知 ) 和 “不 正常 完成 ”( 在 处 理 数据 中 发 
生 错 误 时 发 出 的 通知 ) 这 两 个 概念 。 但 是 ，Rx 和 TPL 数据 流 的 性 能 并 不 相同 。 如 果 执 行 
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需要 计时 的 任务 ， 最 好 使 用 Rx 的 observable 对 象 ， 而 不 是 数据 流 块 。 如 果 进 行 并 行 处 理 ， 
最 好 使 用 数据 流 块 ， 而 不 是 Rx 的 observable 对 象 。 从 概念 上 说 ，Rx 更 像 是 建立 回调 函数 : 
observable 对 象 中 的 每 个 步骤 都 会 直接 调用 下 一 步 。 相 反 ， 数 据 流 网 格 中 的 每 一 块 都 是 互 
相 独 立 的 。Rx 和 TPL 数据 流 有 各 自 的 应 用 领域 ,也 有 一 些 交 又 的 领域 。 男 一 方面 ，Rx 和 
TPL 数据 流 也 非常 适合 同时 使 用 。Rx 和 TPL 数据 流 的 互 操作 性 将 在 7.7 节 详 细 介 绍 。 

















最 常用 的 块 类 型 有 TransformBlock<TInput，TOutput> ( 与 LINQ 的 Select 类 似 )、 
TransformManyBLock<TInput，Toutput> (与 LINQ 的 SelectMany 类 似 ) 和 ActionBLock<T> 
(为 每 个 数据 项 运行 一 个 委托 )。 要 了 解 TPL 数据 流 的 更 多 知识 ， 建 议 阅读 MSDN 的 文档 
和 Guide to Implementing Custom TPL Dataflow Blocks。 


1.6 ”多 线程 编程 简介 


线程 是 一 个 独立 的 运行 单元 ， 每 个 进程 内 部 有 多 个 线程 ， 每 个 线程 可 以 各 自 同 时 执行 指令 。 
每 个 线程 有 自己 独立 的 栈 ， 但 是 与 进程 内 的 其 他 线程 共享 内 存 。 对 某 些 程序 来 说 ， 其 中 有 
一 个 线程 是 特殊 的 ， 例 如 用 户 界面 程序 有 一 个 UI 线程 ， 控 制 台 程序 有 一 个 main 线程 。 


每 个 .NET 程序 都 有 一 个 线程 池 ， 线 程 池 维护 着 一 定数 量 的 工作 线程 ， 这 些 线程 等 待 着 执 
行 分 配 下 来 的 任务 。 线 程 池 可 以 随时 监测 线程 的 数量 。 配 置 线程 池 的 参数 多 达 几 十 个 ， 但 
是 建议 采用 默认 设置 ， 线 程 池 的 默认 设置 是 经 过 仔细 调整 的 ， 适 用 于 绝 大 多 数 现实 中 的 应 
用 场景 。 




















应 用 程序 儿 乎 不 需要 自行 创建 新 的 线程 。 你 若 要 为 COM interop 程序 创建 SAT 线程 ， 就 得 
创建 线程 ， 这 是 唯一 需要 线程 的 情况 。 





线程 是 低级 别 的 抽象 ， 线 程 池 是 稍微 高 级 一 点 的 抽象 ， 当 代码 段 遵循 线程 池 的 规则 运行 
时 ， 线 程 池 就 会 在 需要 时 创建 线程 。 本 书 介绍 的 技术 抽象 级 别 更 高 : 并 行 和 数据 流 的 处 理 
队列 会 根据 情况 遵循 线程 池 运行 。 抽 象 级 别 更 高 ， 正 确 代 码 的 编写 就 更 容易 。 

















基于 这 个 原因 ， 本 书 根本 不 介绍 Thread 和 Backgroundworker 这 两 种 类 型 。 它 们 曾经 非常 
流行 ， 但 那个 时 代 已 经 过 去 了 。 


1.7 并 发 编程 的 集合 

并 发 编程 所 用 到 的 集合 有 两 类 : 并 发 集合 和 不 可 变 集合 。 这 两 种 类 别 的 集合 将 在 第 8 章 
详细 介绍 。 多 个 线程 可 以 用 安全 的 方式 同时 更 新 并 发 集合 。 大 多 数 并 发 集合 使 用 快照 
(snapshot) ， 当 一 个 线程 在 增加 或 删除 数据 时 ， 另 一 个 线程 也 能 枚 举 数据 。 比 起 给 常规 集 
合 加 锁 以 保护 数据 的 方式 ， 采 用 并 发 集合 的 方式 要 高 效 得 多 。 


不 可 变 集合 则 有 些 不 同 。 不 可 变 集合 实际 上 是 无 法 修改 的 。 要 修改 一 个 不 可 变 集合 ， 需 要 
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建立 一 个 新 的 集合 来 代表 这 个 被 修改 了 的 集合 。 这 看 起 来 效率 非常 低 ， 但 是 不 可 变 集合 的 
各 个 实例 之 间 尽 可 能 多 地 共享 存储 区 ， 因 此 实际 上 效率 没 想象 得 那么 差 。 不 可 变 集合 的 优 
点 之 一 ， 就 是 所 有 的 操作 都 是 简洁 的 ， 因 此 特别 适合 在 函数 式 代码 中 使 用 。 


1.8 现代 设计 
大 多 数 并 发 编程 技术 有 一 个 类 似 点 : 它们 本 质 上 都 是 国 数 式 (functional) 的 。 这 里 
“functional” 的 意思 不 是 “实用 , 能 完成 任务 ”， 而 是 把 它 作为 一 种 基于 函数 组 合 的 编程 模 
式 。 如 采 你 接受 函数 式 的 编程 理念 ， 并 发 编程 的 设计 就 会 简单 得 多 。 


函数 式 编程 的 一 个 原则 就 是 简洁 (换言之 ， 就 是 避免 副作用 )。 解 决 方案 中 的 每 一 个 片段 
都 用 一 些 值 作 为 输入 ， 生 成 一 些 值 作 为 输出 。 应 该 尽 可 能 避免 让 这 些 段落 依赖 于 全 局 (或 
共享 ) 变量 ， 或 者 修改 全 局 (或 共享 ) 数据 结构 。 不 论 这 个 片段 是 异步 方法 、 并 行 任务 、 
Rx 操作 还 是 数据 流 块 ， 都 应 该 这 么 做 。 当 然 了 ， 具 体 做 法 迟早 会 受到 计算 内 容 的 影响 ， 
但 如 果 能 用 简洁 的 段落 来 处 理 ， 然 后 用 结果 来 执行 更 新 ， 代 码 就 会 更 加 清晰 。 


函数 式 编 程 的 另 一 个 原则 是 不 变性 。 不 变性 是 指 一 段 数据 是 不 能 被 修改 的 。 在 并 发 编程 中 
使 用 不 可 变数 据 的 原因 之 一 ， 是 程序 永远 不 需要 对 不 可 变数 据 进行 同步 。 数 据 不 能 修改 ， 
这 一 事实 让 同步 变 得 没有 必要 。 不 可 变数 据 也 能 避免 副作用 。 在 编写 本 书 时 (2014 年 )， 
虽然 不 可 变数 据 还 没有 被 广泛 接受 ， 但 本 书 中 有 几 节 会 介绍 不 可 变数 据 结构 。 


1 .9 技术 要 点 总 结 


在 .NET 刚 推出 时 ， 就 对 异步 编程 提供 了 一 定 的 支持 。 但 是 异步 编程 一 直 是 很 难 的 ， 直 到 
2012 年 .NET 4.5 (同时 发 布 C# 5.0 和 VB 2012) 引入 async 和 await 这 两 个 关键 字 。 本 书 
中 的 异步 编程 方法 ， 将 全 部 采用 现代 的 async/await。 同 时 介绍 一 些 方法 ， 来 实现 async 和 
老式 异步 编程 模式 的 交互 。 要 支持 老式 平台 的 话 ， 需 要 下 载 NuGet 包 Microsoft.Bcl.Async。 



















































































步 编程 ! 在 .NET 中 ，ASP.NET 管道 已 经 进行 修改 以 支持 async。 对 于 异步 


和 俱 、 不 要 在 基于 .NET 4.0 的 ASPNET 代码 中 使 用 Microsoft.BcL.Async 进行 异 
ASP.NET 项 目 ， 必 须 使 用 .NET 4.5 或 更 高 版 本 。 





.NET 4.0 引入 了 并 行 任务 库 (TPL) ， 完 全 支持 数据 并 行 和 任务 并 行 。 但 是 一 些 资源 较 少 的 
平台 (例如 手机 ) ， 通 常 不 支持 TPL。TPL 是 .NET 框架 自 带 的 。 





Reactive Extensions 团队 已 经 让 它 尽 可 能 多 地 支持 多 种 平台 。Reactive Extensions 和 async、 
await 一 样 ， 对 所 有 类 型 的 应 用 都 有 好 处 ， 包 括 客 户 端 和 服务 器 端 应 用 。Rx 在 NuGet 包 








注 1 英文 中 “函数 式 ” 和 “实用 ”是 同一 个 单词 functional。 译 者 注 
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Rx-Main 中 。 


TPL 数据 流 库 只 支持 较 新 的 平台 ， 它 的 官方 版 本 在 NuGet 包 Microsoft.TpL.DatafLow 中 。 








并 发 编程 的 集合 是 .NET 框架 的 一 部 分 ， 但 是 不 可 变 集合 在 NuGet 包 Microsoft.Bcl. 
Immutable 中 。 表 1-1 列 出 了 各 主流 平台 对 各 种 技术 的 支持 情况 。 


表 1-1: 各 平台 对 并 发 编程 的 支持 











于 全 async 并 行 编程 ” Rx 数据 流 并 发 集合 ”不 可 变 集合 
.NET 4.5 这 Vv Vv NA Vv SA 
.NET 4.0 Wy Vv x Vv 芝 
Mono iOS/Droid Vv Vv Vv Vv vV v 
Windows Store Vv Vv Vv Vv Vv vV 
Windows Phone Apps 8.1 Vv Vv Vv vV Vv Vv 
Windows Phone SL 8.0 Vv x Vv vV x Vv 
Windows Phone SL 7.1 Vv x WA x x x 
Silverlight 5 vV x Vv x x x 
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第 2 章 


异步 编程 基础 





本 章 介 绍 在 异步 操作 中 使 用 async 和 await 的 基础 知识 。 本 章 只 涉及 本 质 上 适合 异步 的 操 
作 ， 例 如 HTTP 请 求 、 数 据 库 指令 、Web 服务 调用 等 。 


如 果 要 把 CPU 密集 型 的 操作 当 作 异步 操作 来 处 理 ( 让 它 不 阻塞 UI 线程 )， 请 阅读 第 3 章 
和 7.4 节 。 另 外 ， 本 音 只 涉及 只 局 动 一 次 、 结 束 一 次 的 操作 。 如 有 果 要 处 理事 件 流 ， 请 阅读 
第 5 章 。 











要 在 老 版 本 的 平台 上 使 用 async， 需 要 安装 NuGet 包 Microsoft.Bcl.Async。 有 些 平台 本 身 
就 支持 async， 而 有 些 平台 需要 安装 这 个 NuGet 包 ( 见 表 2-1)。 





表 2-1: 各 平台 对 async 的 支持 情况 





平 舍 async 
.NET 4.5 Vv 
.NET 4.0 NuGet 
Mono iOS/Droid Vv 
Windows Store Vv 
Windows Phone Apps 8.1 Vv 
Windows Phone SL 8.0 Vv 
Windows Phone SL 7.1 NuGet 
Silverlight 5 NuGet 


2.1 暂停 一 段 时 间 
问题 


需要 让 程序 (以 异步 方式 ) 等 待 一 段 时 间 。 这 在 进行 单元 测试 或 者 实现 重 试 延迟 时 非常 
有 用 。 本 解决 方案 也 能 用 于 实现 简单 的 超时 。 


解决 方案 


Task 类 有 一 个 返回 Task 对 象 的 静态 函数 Delay， 这 个 Task 对 象 会 在 指定 的 时 间 后 完成 。 














如 果 程 序 使 用 Microsoft.Bcl.Async 这 个 NuGet 库 ， 则 Delay 是 TaskEx 类 的 
成 员 ， 而 不 是 Task 类 的 成 员 。 











下 面 的 例子 用 于 单元 测试 ， 定 义 了 一 个 异步 完成 的 任务 。 在 模拟 一 个 异步 操作 时 ， 至 少 要 
测试 “同步 成 功 "“ 异 步 成 功 ” 和 “异步 失败 ”这 三 种 情况 ， 这 一 点 很 重要 。 下 面 的 例子 
返回 一 个 Task 对 象 ， 用 于 “异步 成 功 ” 测 试 。 














static async Task<T> DelayResult<T>(T result, TimeSpan delay) 


{ 
await Task.Delay(delay); 
return result; 


3 
下 一 个 例子 实现 了 一 个 简单 的 指数 退 避 。 指 数 退 避 是 一 种 重 试 策略 ， 重 试 的 延迟 时 间 会 逐 
次 增加 。 在 访问 Web 服务 时 ， 最 好 的 方式 就 是 采用 指数 退 避 ， 它 可 以 防止 服务 器 被 太 多 的 
重 试 阻 塞 。 


在 实际 产品 的 开发 中 ， 建 议 你 采用 更 周密 的 方案 ， 例 如 微软 企业 库 中 的 瞬间 
错误 处 理 模块 (Transient Error Handling Block)。 下 面 的 代码 只 是 一 个 使 用 
Task.Delay 的 简单 例子 。 





























static async Task<string> DownloadStringWithRetries(string uri) 


{ 


using (var client = new HttpClient()) 


// 第 1 次 重 试 前 等 1 秒 , 第 ?2 次 等 2 秒 , 第 3 次 等 4 秒 。 
var nextDelay = TimeSpan.FromSeconds(1); 


for (int i = 0; i != 3; ++i) 
{ 

try 

{ 





return await client.GetStringAsync(uri); 


} 


catch 
{ 
3 


await Task.Delay(nextDelay); 
nextDelay = nextDelay + nextDelay; 


} 
// 最 后 重 试 一 次 ， 以 便 让 调用 者 知道 出 错 信息 。 


return await client.GetStringAsync(uri); 








} 


最 后 的 例子 用 Task.Delay 实现 一 个 简单 的 超时 功能 。 本 例 中 代码 的 目的 是 : 如 果 服 务 在 3 
秒 内 没有 响应 ， 就 返回 null。 





static async Task<string> DownloadStringWithTimeout(string uri) 


{ 


Using (var client = new HttpClient()) 


{ 
var downloadTask = client.GetStringAsync(uri); 
var timeoutTask = Task.Delay(3000); 


var completedTask = await Task.WhenAny(downloadTask, timeoutTask); 
if (completedTask == timeoutTask) 

return null; 
return await downloadTask; 


讨论 
Task.Delay 适合 用 于 对 异步 代码 进行 单元 测试 或 者 实现 重 试 逻辑 。 要 实现 超时 功能 的 话 ， 
最 好 使 用 CancellationToken。 








2.5 节 介 绍 如何 用 Task.WhenAny 来 判断 哪个 任务 是 首先 完成 的 。 








9.3 节 介 绍 用 CancellationToken 实现 超时 功能 的 方法 。 


2.2 返回 完成 的 任务 


问题 
如 何 实现 一 个 具有 异步 签名 的 同步 方法 。 如 果 从 异步 接口 或 基 类 继承 代码 ， 但 希望 用 同步 
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的 方法 来 实现 它 ， 就 会 出 现 这 种 情况 。 对 异步 代码 做 单元 测试 ， 以 及 用 简单 的 生成 方法 存 
根 (stub) 或 者 模拟 对 象 (mock) 来 产生 异步 接口 ， 这 两 种 情况 下 都 可 使 用 这 种 技术 。 


解决 方案 
可 以 使 用 Task.FromResult 方法 创建 并 返回 一 个 新 的 Task<T> 对 象 ， 这 个 Task 对 象 是 已 经 
完成 的 ， 并 有 指定 的 值 。 





interface IMyAsyncInterface 


{ 

Task<int> GetValueAsync(); 
} 
class MySynchronousImplementation : IMyAsyncInterface 
{ 

public Task<int> GetValueAsync() 

€ 

return Task.FromResult(13); 

} 

} 





如 果 使 用 了 Microsoft.Bcl.Async，FromResult 方法 就 在 TaskEx 类 中 。 





讨论 

在 用 同步 代码 实现 异步 接口 时 ， 要 避免 使 用 任何 形式 的 阻塞 操作 。 在 异步 方法 中 进行 阻塞 
操作 ， 然 后 返回 一 个 完成 的 Task 对 象 ， 这 种 做 法 并 不 可 取 。 作 为 一 个 反例 ， 我 们 来 看 一 
下 .NET 4.5 中 Console 类 的 文本 读 取 器 。Console.In.ReadLineAsync 一 定 会 阻塞 调用 它 的 
线程 ， 直 到 它 读 取 完 一 行文 字 ， 然 后 会 返回 一 个 已 完成 的 Task 对 象 。 这 种 实现 方式 并 不 
直观 ， 很 多 开发 人 员 也 觉得 很 奇怪 。 一 旦 异步 方法 阻塞 ,调用 它 的 线程 就 无 法 启动 其 他 任 
务 ， 这 会 干扰 程序 的 并 发 性 ， 其 至 可 能 产生 死 锁 。 


Task.FromResult 只 能 提供 结果 正确 的 同步 Task 对 象 。 如 果 要 让 返回 的 Task 对 象 有 一 个 其 
他 类 型 的 结果 (例如 以 NotImplementedException 结束 的 Task 对 象 )， 就 得 自行 创建 使 用 
TaskCompletionSource 的 辅助 方法 : 






































static Task<T> NotImpLementedAsync<T>() 


{ 
var tcs = new TaskCompletionSource<T>(); 
tcs.SetException(new NotImplementedException()); 
return tcs.Task; 

3 





从 概念 上 讲 ，Task.FromResult 只 不 过 是 TaskCompletionSource 的 一 个 简化 版 本 ， 它 与 上 面 
的 代码 非常 类 似 。 


如 果 用 Task.FromResult 反复 调用 同一 参数 ， 则 可 考虑 用 一 个 实际 的 task 变量 。 例 如 ， 可 
以 一 次 性 建立 一 个 结果 为 0 的 Task<int> 对 象 ， 在 以 后 的 调用 中 就 不 需要 创建 额外 的 实例 
了 ， 这 样 可 减少 垃圾 回收 的 次 数 : 





private static readonly Task<int> zeroTask = Task.FromResult(0); 
static Task<int> GetValueAsync() 


{ 
return zeroTask; 
} 
参阅 
6.1 节 介 绍 异步 方法 的 单元 测试 。 





10.1 节 介 绍 async 方法 的 继承 。 


2.3 报告 进度 


问题 
异步 操作 执行 的 过 程 中 ， 需 要 展示 操作 的 进度 。 


解决 方案 
使 用 IProgress<T> 和 Progress<T> 类 型 。 编 写 的 async 方法 需要 有 IProgress<T> 参数 ， 其 
中 T 是 需要 报告 的 进度 类 型 : 


static async Task MyMethodAsync(IProgress<double> progress = nuLL) 


{ 
double percentComplete = 0; 
while (!done) 


if CF ogress != null) 
progress.Report(percentComplete); 
} 
调用 上 述 方 法 的 代码 : 
static async Task CallMyMethodAsync() 


{ 


var progress = new Progress<double>(); 
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progress.ProgressChanged += (sender, args) => 


{ 
}; 
await MyMethodAsync(progress); 
} 
$ * 八 
讨论 


按照 惯例 ， 如 果 不 需要 报告 进度 ，IProgress<T> 参数 可 以 是 nutl， 因 此 在 async 方法 中 一 


定 要 对 此 进行 检查 。 





需要 注意 的 是 ，IProgress<T>.Report 方法 可 以 是 异步 的 。 这 意味 着 真正 报告 进度 之 前 ， 
MyMethodAsync 方法 会 继续 运行 。 基 于 这 个 原因 ， 最 好 把 T 定义 为 一 个 不 可 变 类 型 ， 或 者 至 
少 是 值 类 型 。 如 果 T 是 一 个 可 变 的 引用 类 型 ， 就 必须 在 每 次 调用 IProgress<T>.Report 时 ， 





创建 一 个 单独 的 副本 。 
Progress<T> 会 在 创建 时 捕获 当前 上 下 文 ， 并 且 在 这 个 上 下 文中 调用 





如 果 在 UI 线程 中 创建 了 Progress<T>， 就 能 在 Progress<T> 的 回调 函 





步 方 法 是 在 后 台 线 程 中 调用 Report 的 。 
如 有 果 一 个 方法 可 以 报告 进度 ， 就 该 尽量 做 到 可 以 被 取消 。 


参阅 
9.4 节 介 绍 如 何 实现 异步 方法 的 取消 功能 。 
2.4 ”等 待 一 组 任务 完成 


问题 
执行 儿 个 任务 ， 等 待 它 们 全 部 完成 。 


解决 方案 





回调 函数 。 这 意味 着 ， 
数 中 更 新 UI， 即 使 异 


框架 提供 的 Task.WhenAll 方法 可 以 实现 这 个 功能 。 这 个 方法 的 输入 为 若干 个 任务 ， 当 所 有 


任务 都 完成 时 ， 返 回 一 个 完成 的 Task 对 象 : 
Task task1 = Task.Delay(TimeSpan.FromSeconds(1)); 
Task task2 = Task.Delay(TimeSpan.FromSeconds(2)); 
Task task3 = Task.Delay(TimeSpan.FromSeconds(1)); 


await Task.WhenAll(task1, task2, task3); 
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如 有 果 所 有 任务 的 结果 类 型 相同 ， 并 且 全 部 成 功 地 完成 ， 则 Task.WhenAll 返回 存 有 每 个 任务 
执行 结果 的 数组 : 





Task task1 = Task.FromResuLt(3); 

Task task2 = Task.FromResuLt(5); 

Task task3 = Task.FromResult(7); 

int[] results = await Task.WhenAll(task1, task2, task3); 

// "results" 含有 { 3, 5, 7 } 
Task.WhenAll 方法 有 以 IEnumerable 类 型 作为 参数 的 重 载 ， 但 建议 大 家 不 要 使 用 。 只 要 异步 代 
码 与 LINQ 结合 ， 显 式 的 “具体 化 ”序列 ( 即 对 序列 求 值 ， 创 建 集合 ) 就 会 使 代码 更 清晰 : 





static async Task<string> DownloadAllAsync(IEnumerable<string> urls) 


{ 


var httpClient = new HttpClient(); 


// 定义 每 一 个 url 的 使 用 方法 。 
var downloads = urls.Select(url => httpClient.GetStringAsync(url)); 
// 注意 ， 到 这 里 ， 序 列 还 没有 求 值 ， 所 以 所 有 任务 都 还 没 真正 启动 。 


// 下 面 ， 所 有 的 URL 下 载 同步 开始 。 


Task<string>[] downLoadTasks = downloads.ToArray(); 
// 到 这 里 ， 所 有 的 任务 已 经 开始 执行 了 。 


// 用 异步 方式 等 待 所 有 下 载 完 成 。 
string[] htmLPages = await Task.WhenAll(downloadTasks); 


























return string.Concat(htmLPages ) ; 


如 果 使 用 Microsoft.Bcl.Async 这 个 NuGet 库 ， 则 WhenALL 是 TaskEx 类 的 成 
员 ， 而 不 是 Task 类 的 成 员 。 








讨论 

如 果 有 一 个 任务 抛 出 异常 ， 则 Task.WhenAll 会 出 错 ， 并 把 这 个 异常 放 在 返回 的 Task 中 。 
如 果 多 个 任务 抛 出 异常 ， 则 这 些 异常 都 会 放 在 返回 的 Task 中 。 但 是 ， 如 果 这 个 Task 在 被 
await 调用 ， 就 只 会 抛 出 其 中 的 一 个 异常 。 如 果 要 得 到 每 个 异常 ， 可 以 检查 Task.WhenALL 
返回 的 Task 的 Exception 属性 : 
























































static async Task ThrowNotImplementedExceptionAsync() 


{ 
. 


throw new NotImplementedException(); 
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static async Task ThrowInvalidOperationExceptionAsync() 


{ 


throw new InvalidOperationException(); 


} 
static async Task ObserveOneExceptionAsync() 
{ 
var task1 = ThrowNotImplementedExceptionAsync(); 
var task2 = ThrowInvalidOperationExceptionAsync(); 
try 
await Task.WhenAll(task1, task2); 
} 
catch (Exception ex) 
// ex 要 么 是 NotImplementedException， 要 么 是 InvaLid0perationException 
} 
} 
static async Task ObserveAllExceptionsAsync() 
{ 
var task1 = ThrowNotImplementedExceptionAsync(); 
var task2 = ThrowInvalidOperationExceptionAsync(); 
Task allTasks = Task.WhenAll(task1, task2); 
try 
€ 
await allTasks; 
} 
catch 
{ 
AggregateException allExceptions = allTasks.Exception; 
} 
小 


使 用 Task.WhenAll 时 ， 我 一 般 不 会 检查 所 有 的 异常 。 通 常情 况 下 ， 只 处 
够 了 ， 没 必要 处 理 全 部 错误 。 





参阅 
2.5 节 介 绍 等 待 一 批 任务 中 的 任意 一 个 完成 的 方法 。 
2.6 节 介 绍 等 待 一 批 任务 完成 ， 并 逐个 处 理 完成 的 任务 。 





2.8 市 介绍 对 async 方法 的 异常 处 理 。 

















E 第 一 个 错误 就 足 





2.5 等 待 任意 一 个 任务 完成 


问题 

执行 若干 个 任务 ， 只 需要 对 其 中 任意 一 个 的 完成 进行 啊 应 。 这 主要 用 于 : 对 一 个 操作 进行 
多 种 独立 的 尝试 ， 只 要 一 个 尝试 完成 ， 任 务 就 算 完成 。 例 如 ， 同 时 向 多 个 Web 服务 询问 股 
票 价格 ， 但 是 只 关心 第 一 个 响应 的 。 


解决 方案 
使 用 Task.WhenAny 方法 。 该 方法 的 参数 是 一 批 任务 ， 当 其 中 任意 一 个 任务 完成 时 就 会 返 


中 
回 。 作 为 返回 值 的 Task 对 象 ， 就 是 那个 完成 的 任务 。 不 要 觉得 迷惑 ， 这 个 昕 起 来 有 点 难 
但 从 代码 看 很 容易 实现 : 






































// 返回 第 一 个 响应 的 URL 的 数据 长 度 。 
private static async Task<int> FirstRespondingUrlAsync(string urlA, string urlB) 


{ 
var httpClient = new HttpClient(); 





// 并 发 地 开始 两 个 下 载 任务 。 
Task<byte[]> downloadTaskA = httpClient.GetByteArrayAsync(urlA); 
Task<byte[]> downloadTaskB = httpClient.GetByteArrayAsync(urlB); 





// 等 待 任意 一 个 任务 完成 。 
Task<byte[]> completedTask = 
await Task.WhenAny(downloadTaskA, downloadTaskB); 











// 返回 从 URL 得 到 的 数据 的 长 度 。 
byte[] data = await completedTask; 
return data.Length; 


如 果 使 用 Microsoft.Bcl.Async 这 个 NuGet 库 ， 则 WhenAny 是 TaskEx 类 的 成 
员 ， 而 不 是 Task 类 的 成 员 。 





讨论 

Task.WhenAny 返回 的 task 对 象 永 远 不 会 以 “故障 ”或 “已 取消 ”状态 作为 结束 。 该 方法 的 
运行 结果 总 是 一 个 Task 首先 完成 。 如 果 这 个 任务 完成 时 有 异常 ， 这 个 异常 也 不 会 传递 给 
Task.WhenAny 返回 的 Task 对 象 。 因 此 ， 通 常 需要 在 Task 对 象 完成 后 继续 使 用 await。 





























第 一 个 任务 完成 后 ， 考 虑 是 否 要 取消 剩 下 的 任务 。 如 果 其 他 任务 没有 被 取消 ， 也 没有 被 继 
续 await， 那 它们 就 处 于 被 遗弃 的 状态 。 被 遗弃 的 任务 会 继续 运行 直到 完成 ， 它 们 的 结果 


























异步 编程 基础 | 25 





会 被 忽略 ， 抛 出 的 任何 异常 也 会 被 忽略 。 


使 用 Task.WhenAny 可 以 实现 超时 功能 (例如 用 Task.Delay 作为 其 中 的 一 个 任务 )， 但 这 种 
做 法 并 不 可 取 。 更 常见 的 做 法 是 采用 专门 有 取消 功能 的 超时 函数 ， 并 且 取 消 功 能 还 有 一 个 
好 处 ， 就 是 可 以 把 已 经 超时 的 任务 彻底 取消 。 




















Task.WhenAny 的 另 一 个 反 模式 是 处 理 已 完成 的 任务 。 一 种 做 法 是 把 所 有 任务 放 在 一 个 列表 





里 ， 在 一 个 任务 完成 后 就 把 它 移 除 ， 











这 种 做 法 看 起 来 好 像 有 道理 。 问 题 是 这 种 做 法 需要 执 





行 的 时 间 是 OW^2)， 而 实际 上 有 时 间 复 杂 度 为 OOV) 的 算法 。 时 间 复 杂 度 为 OOV) 的 正确 算 


法 将 在 2.6 节 介 绍 。 


参阅 


2.4 市 介绍 异步 地 等 待 所 有 任务 完成 。 


2.6 市 介绍 等 待 一 批 任务 完成 ， 并 对 每 个 任务 进行 处 理 。 


9.3 市 介绍 使 用 取消 标志 来 实现 超时 功能 。 


2.6 任务 完成 时 的 处 理 


问题 





正在 await 一 批 任 务 ， 希 望 在 每 个 任务 完成 时 对 它 做 一 些 处 理 。 另 外 ， 和 希望 在 任务 一 完成 
就 立即 进行 处 理 ， 而 不 需要 等 待 其 他 任务 。 











举 个 例子 ， 下 面 的 代码 启动 了 3 个 延 时 任务 ， 然 后 对 每 一 个 进行 avatt。 





static async Task<int> DelayAndReturnAsync(int val) 


{ 


await Task.Delay(TimeSpan.FromSeconds(val)); 


return val; 


} 


// 当前 ， 此 方法 输出 “2”， 3” 
// 我 们 希望 它 输 出 “1”,“2”， 








cy 
3 


static async Task ProcessTasksAsync() 


{ 
// 创建 任务 队列 。 





Task<int> taskA = DelayAndReturnAsync(2); 
Task<int> taskB = DelayAndReturnAsync(3); 
Task<int> taskC = DelayAndReturnAsync(1); 


var tasks = new[] { taskA, 


// 按 顺 序 await 每 个 任务 。 
foreach (var task in tasks 


taskB, taskC }; 


) 





大 
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var result = await task; 
Trace.WriteLine(result); 


} 
虽然 列表 中 的 第 二 个 任务 是 首先 完成 的 ， 当 前 这 段 代 码 仍 按 列表 的 顺序 对 任务 进行 await。 
我 们 希望 按 任务 完成 的 次 序 进行 处 理 〈 例 如 Trace.NriteLine) ， 不 必 等 待 其 他 任务 。 
解决 方案 


解决 这 个 问题 的 方法 有 好 几 种 。 本 闻 首 先 介绍 一 种 推荐 大 家 使 用 的 方法 ， 另 一 种 则 将 在 
“讨论 部 分 ”给 出 。 























最 简单 的 方案 是 通过 引入 更 高 级 的 async 方法 来 await 任务 ， 并 对 结果 进行 处 理 ， 从 而 重 
新 构建 代码 。 提 取出 处 理 过 程 后 ， 代 码 就 明显 简化 了 。 





a 

















static async Task<int> DelayAndReturnAsync(int val) 


{ 
await Task.Delay(TimeSpan.FromSeconds(val)); 
return val; 
} 
static async Task AwaitAndProcessAsync(Task<int> task) 
{ 
var result = await task; 
Trace.WriteLine(result); 
} 


// 现在 ,这 个 方法 输出 “1”,，“2”，“3”。 
static async Task ProcessTasksAsync() 











{ 
// 创建 任务 队列 。 
Task<int> taskA = DelayAndReturnAsync(2); 
Task<int> taskB = DelayAndReturnAsync(3); 
Task<int> taskC = DelayAndReturnAsync(1); 
var tasks = new[] { taskA, taskB, taskC }; 
var processingTasks = (from t in tasks 
select AwaitAndProcessAsync(t)).ToArray(); 
// 等 待 全 部 处 理 过 程 的 完成 。 
await Task.WhenAll(processingTasks); 
} 
上 面 的 代码 也 可 以 这 么 写 : 
static async Task<int> DelayAndReturnAsync(int val) 
{ 
await Task.Delay(TimeSpan.FromSeconds(val)); 
return val; 
} 
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// 现在 ， 这 个 方法 输出 “1”， "2”， “3”。 

static async Task ProcessTasksAsync() 

{ 
// 创建 任务 队列 。 
Task<int> taskA = DelayAndReturnAsync(2); 
Task<int> taskB = DelayAndReturnAsync(3); 
Task<int> taskC = DelayAndReturnAsync(1); 
var tasks = new[] { taskA, taskB, taskC }; 





var processingTasks = tasks.Select(async 七 => 


{ 
var result = await t; 
Trace.WriteLine(result); 
}) .ToArray(); 


// 等 待 全 部 处 理 过 程 的 完成 。 
await Task.WhenAll(processingTasks); 





} 


重 构 后 的 代码 是 解决 本 问题 最 清晰 、 可 移植 性 最 好 的 方法 。 不 过 它 与 原始 代码 有 一 个 细微 
的 区 别 。 重 构 后 的 代码 并 发 地 执行 处 理 过 程 ， 而 原始 代码 是 一 个 接着 一 个 地 处 理 。 大 多 数 
情况 下 这 不 会 有 什么 影响 ， 但 如 果 不 允 许 有 这 种 区 别 ， 可 考虑 使 用 锁 (11.2 节 介 绍 ) 或 者 
后 面 介绍 的 可 选 方案 。 


讨论 

如 果 上 面 重 构 代 码 的 办 法 不 可 取 ， 我 们 还 有 可 选 方案 。Stephen Toub 和 Jon Skeet 都 开发 了 
一 个 扩展 方法 ， 可 以 让 任务 按 顺 序 完成 ， 并 返回 一 个 任务 数组 。Setphen Toub 的 解决 方案 
见 博客 文档 “Parallel Programming with .NET” (http:Wtcn/RhR2V6n) ，Jon Skeet 的 解决 方 
案 见 他 的 博客 (http://t.cn/RhR2xu9)。 








这 个 扩展 方法 也 可 在 开源 项 目 AsyncEx 库 (https:Wnitoasyncex.codeplex.com ) 
找到 ， 它 在 NuGet 包 Nito.AsyncEx (https://www.nuget.org/packages/Nito. 
AsyncEx) 中 。 








使 用 像 OrderByCompletion 这 样 的 扩展 方法 ， 就 能 让 修改 原 代 码 的 量 降 到 最 低 。 





static async Task<int> DelayAndReturnAsync(int val) 
{ 
await Task.Delay(TimeSpan.FromSeconds(val)); 
return val; 


} 


// 现在 ， 这 个 方法 输出 “1”,，“2”,，“3”。 
static async Task UseOrderByCompletionAsync() 


{ 
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// 创建 任务 队列 。 
Task<int> taskA = DelayAndReturnAsync(2); 
Task<int> taskB = DelayAndReturnAsync(3); 
Task<int> taskC = DelayAndReturnAsync(1); 


var tasks = new[] { taskA, taskB, taskC }; 


// 等 待 每 一 个 任务 完成 。 
foreach (var task in tasks.OrderByCompletion()) 





{ 
var result = await task; 
Trace.WriteLine(result); 
3 
} 
My 
参阅 


2.4 市 介绍 异步 地 等 待 一 系列 任务 完成 。 


2.7 ”避免 上 下 文 延 续 


问题 
在 默认 情况 下 ， 一 个 async 方法 在 被 await 调用 后 恢复 运行 时 ， 会 在 原来 的 上 下 文中 运行 。 
如 果 是 UI 上 下 文 ， 并 且 有 大 量 的 async 方法 在 UI 上 下 文中 恢复 ， 就 会 引起 性 能 上 的 问题 。 


解决 方案 
为 了 避免 在 上 下 文中 恢复 运行 ， 可 让 awatt 调用 Configurehwatt 方法 的 返回 值 ， 参 数 


continueOnCapturedContext 设 为 false: 











async Task ResumeOnContextAsync() 


await Task.Delay(TimeSpan.FromSeconds(1)); 
// 这 个 方法 在 同一 个 上 下 文中 恢复 运行 。 
} 
async Task ResumeWithoutContextAsync() 
b await Task.Delay(TimeSpan.FromSeconds(1)).ConfigureAwait(false); 
j // 这 个 方法 在 恢复 运行 时 ， 会 丢弃 上 下 文 。 


讨论 


如 果 在 UI 线程 上 运行 的 延续 任务 (continuation) 太 多 ,会 导致 性 能 上 的 问题 。 








六 


为 使 系统 
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变 慢 的 方法 不 止 一 个 ， 所 以 这 种 类 型 的 性 能 问题 是 很 难 诊断 的 。 而 且 随 着 程序 复杂 性 的 增 
加 ，UI 性 能 会 因为 “成 千 上 万 的 剪纸 ”( 在 UI 线程 中 有 太 多 任务 切换 ， 就 像 剪 纸 ) 而 变 慢 。 
真正 的 问题 是 ， 在 UI 线程 中 有 多 少 延 续 任 务 ， 才 算是 太 多 ? 这 没有 固定 的 答案 ， 不 过 微 
软 公司 的 Lucian Wischik 公布 了 一 个 WinRT 团队 的 指导 标准 (http://t.cn/RhR2KGi) : 每 秒 
100 个 左右 尚 可 ， 但 每 秒 1000 个 左右 就 太 多 了 。 



































最 好 在 一 开始 就 避免 这 个 问题 。 对 于 每 一 个 async 方法 ， 如 有 果 它 没有 必要 恢复 到 原来 的 上 
下 文 ， 就 要 使 用 ConfigureAwait。 这 么 做 没有 什么 坏处 。 


还 有 一 个 好 点 子 ， 就 是 在 编写 async 代码 时 特别 注意 上 下 文 。 通 常 一 个 async 方法 要 么 需 
要 上 下 文 (处 理 UI 元 素 或 ASP.NET 请 求 /响应 ) ， 要 么 需要 摆脱 上 下 文 (执行 后 台 指 令 )。 
如 果 一 个 asnync 方法 的 一 部 分 需要 上 下 文 、 一 部 分 不 需要 上 下 文 ， 则 可 考虑 把 它 拆 分 为 两 
个 (或 更 多 ) async 方法 。 这 种 做 法 有 利于 更 好 地 将 代码 组 织 成 不 同 层 次 。 





参阅 

第 1 章 简要 介绍 了 异步 编程。 

2.8 处 理 async Task 方 法 的 异常 

问题 

对 任何 设计 来 说 ， 异 常 处 理 都 是 一 个 关键 的 部 分 。 只 考虑 成 功 情况 的 设计 是 很 简单 的 ， 但 


是 正确 的 设计 必须 要 能 处 理 异常 。 还 好 ， 处 理 async Task 方法 的 异常 是 很 简单 、 很 直观 的 。 


解决 方案 


可 以 用 简单 的 try/catch 来 捕获 异常 ， 和 同步 代码 使 用 的 方法 一 样 : 











static async Task ThrowExceptionAsync() 


{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
throw new InvalidOperationException("Test"); 
} 
static async Task TestAsync() 
{ 
try 
{ 


await ThrowExceptionAsync(); 


catch (InvalidOperationException) 





} 


在 async Task 方法 中 引发 的 异常 ， 存 放 在 返回 的 Task 对 象 中 。 只 有 当 Task 对 象 被 await 
调用 时 ， 才 会 引发 异常 : 














static async Task ThrowExceptionAsync() 





{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
throw new InvalidOperationException("Test"); 
} 
static async Task TestAsync() 
{ 
// 抛 出 异常 并 将 其 存储 在 Task 中 。 
Task task = ThrowExceptionAsync(); 
try 
// Task 对 象 被 await 调用 ， 异 常 在 这 里 再 次 被 引发 。 
await task; 
catch (InvalidOperationException) 
// 这 里 ， 异 常 被 正确 地 捕获 。 
} 
* * 八 
讨论 








从 async Task 方法 中 抛 出 的 异常 会 被 捕获 并 放 在 返回 的 Task 对 象 中 。 因 为 async void 方法 没 
有 返回 Task 对 象 ， 无 法 存放 异常 ， 所 以 做 法 就 会 不 同 。 我 们 将 在 另 一 节 介 绍 这 方面 的 内 容 。 


当 await 调用 有 异常 的 Task 对 象 时 ， 对 象 里 的 第 一 个 异常 会 重新 抛 出 。 若 你 对 重新 抛 出 异 
常 的 问题 比较 熟悉 的 话 ， 就 会 担心 栈 轨迹 是 否 会 出 错 。 请 放心 : 异常 重新 抛 出 时 ， 原 始 的 
栈 轨迹 会 被 正确 地 保存 。 

这 种 安排 看 起 来 有 些 复杂 ， 但 是 当 一 切 复杂 性 紧密 配合 后 ， 就 只 需要 很 简单 的 代码 。 一 般 
情况 下 ， 需 要 把 异常 从 异步 方法 中 传递 出 来 。 为 此 ， 只 需要 用 await 调用 异步 方法 返回 的 
Task 对 象 ， 异 常 就 会 很 顺利 地 传递 出 来 。 




















有 些 情况 下 (例如 Task.WhenAll)， 一 个 Task 对 象 包含 多 个 异常 ， 而 await 只 会 重新 抛 出 
第 一 个 。2.4 节 有 一 个 处 理 所 有 异常 的 例子 。 





参阅 


2.4 市 介绍 如 何等 待 多 个 任务 。 
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2.9 节 介 绍 如 何 捕 获 async void 方法 的 异常 。 
6.2 节 介绍 如 何 对 async Task 方法 抛 出 的 异常 做 单元 测试 。 


2.9 处 理 async void 方法 的 异常 


问题 
需要 处 理 从 async void 方法 传递 出 来 的 异常 。 


解决 方案 
没有 什么 好 的 办 法 。 如 果 可 能 的 话 ， 方 法 的 返回 类 型 不 要 用 void， 把 它 改 为 Task。 某 些 
情况 下 这 是 不 可 能 的 ， 例 如 ， 需 要 对 一 个 ICommand 的 实现 (必须 返回 void) 做 单元 测试 。 
这 种 情况 下 ， 可 以 为 Execute 方法 提供 一 个 返回 Task 类 型 的 重 载 ， 就 像 这 样 ， 














sealed class MyAsyncCommand : ICommand 








{ 
async void ICommand.Execute(object parameter) 
{ 
await Execute(parameter); 
} 
public async Task Execute(object parameter) 
{ 
. // 这 里 实现 异步 操作 。 
} 
. // 其 他 成 员 (CanExecute 等 )。 
} 

















最 好 不 要 从 async void 方法 传递 出 异常 。 如 果 必 须 使 用 async void 方 法， 可 考虑 把 所 有 
代码 放 在 try 块 中 ， 直 接 处 理 异 常 。 


处 理 async void 方 法 的 异常 还 有 一 个 办 法 。 一 个 异常 从 async void 方法 中 传递 出 来 时 ， 

在 SynchronizationContext 中 引发 出 来 。 当 async void 方法 启动 时 ， ee 
就 处 于 激活 状态 。 如 果 系 统 运行 环境 支持 SynchronizationContext， 通 常 就 可 以 在 全 局 范围 
内 处 理 这 些 顶层 的 异常 常 。 例 如 ，WPEF 有 AppLication.DispatcherUnhandLedException，WinRT 
有 Application.UnhandledException，ASP.NET 有 Application_Error。 












































通过 控制 SynchronizationContext， 也 可 以 处 理 从 async void 方法 传 出 的 异常 。 自 己 编写 
SynchronizationContext 的 工作 量 太 大 ， 可 以 使 用 免费 的 NuGet 库 Nito.AsyncEx， 里 面 有 
AsyncContext 类 。AsyncContext 可 以 在 没有 自 带 SynchronizationContext 的 场合 发 挥 作用 ， 

例如 控制 台 程 序 、Win32 服务 程序 。 下 面 的 例子 是 在 控制 台 程 序 中 使 用 AsyncContext， 其 



































中 async 方法 不 返回 Task， 但 AsyncContext 仍 能 在 async void 方法 中 起 作用 : 


static class Program 


{ 
static int Main(string[] args) 
{ 
try 
{ 
return AsyncContext.Run(() => MainAsync(args)); 
catch (Exception ex) 
{ 
Console.Error.WriteLine(ex); 
return -1; 
} 
} 
static async Task<int> MainAsync(string[] args) 
{ 
} 


讨论 
推荐 使 用 async Task 而 不 是 async void， 原 因 之 一 就 是 返回 Task 的 方法 更 容易 测试 。 至 
少 要 用 Task 方法 重 载 void 方法 ， 那 样 可 以 提供 便于 测试 的 API 外 壳 。 





如 果 你 确实 需要 自己 编写 SynchronizationContext 类 (例如 AsyncContext), 千 万 不 要 把 
这 个 SynchronizationContext 类 放 到 不 属于 你 的 线程 上 。 作 为 通用 的 准则 ， 不 要 在 已 经 有 
SynchronizationContext 的 线程 上 (比如 UI 或 ASP.NET request 线程 ) 安装 这 个 类 ， 也 不 
要 在 线程 池 线 程 上 放 SynchronizationContext。 属 于 你 的 线程 有 控制 台 程 序 的 主线 程 ， 还 
有 你 自己 创建 的 所 有 线程 。 








AsyncContext 类 在 NuGet 包 Nito.AsyncEx 中 。 











参阅 


2.8 节 介 绍 async Task 方法 的 异常 处 理 。 








6.3 节 介 绍 async void 方法 的 单元 测试 。 
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第 3 章 


并 行 开发 的 基础 





本 章 介绍 并 行 编程 模式 。 并 行 编程 用 于 分 解 计算 密集 型 的 任务 片段 ， 并 将 它们 分 配给 多 个 
线程 。 这 些 并 行 处 理 方法 只 适用 于 计算 密集 型 的 任务 。 如 果 有 需要 异步 操作 的 任务 (例如 
LO 密集 型 任务 )， 而 你 希望 它 能 并 行 运行 ， 请 看 第 2 章 ， 特 别 是 2.4 市 。 
































本 章 介 绍 的 并 行 处 理 概念 是 任务 并 行 库 (TPL) 的 一 部 分 。 它 只 在 .NET 框架 中 实现 ， 其 
他 平台 不 一 定 适 用 〈 见 表 3-1)。 


表 3-1: 支持 TPL 的 平台 
平 台 支持 并 行 编 程 
.NET 4.5 
.NET 4.0 
Mono iOS/Droid 





Windows Store 
Windows Phone Apps 8.1 
Windows Phone SL 8.0 
Windows Phone SL 7.1 
Silverlight 5 


到 /A 
3.1 数据 的 并 行 处 理 
问题 
有 一 批 数 据 ， 需 要 对 每 个 元 素 进行 相同 的 操作 。 该 操作 是 计算 密集 型 的 ， 需 要 耗费 一 定 的 时 间 。 


x x < 


x 


35 


解决 方案 
parattet 类 型 有 专门 为 此 设计 的 ForEach 方法 。 下 面 的 例子 使 用 了 一 批 矩 阵 ， 对 每 一 个 扎 
阵 都 进行 旋转 : 


void RotateMatrices(IEnumerable<Matrix> matrices, float degrees) 


{ 
} 


在 某 些 情况 下 需要 尽早 结束 这 个 循环 ， 例 如 发 现 了 无 效 值 时 。 下 面 的 例子 反 转 每 一 个 矩 
阵 ， 但 是 如 果 发 现 有 无 效 的 箱 阵 ， 则 中 断 循 环 : 


Parallel.ForEach(matrices, matrix => matrix.Rotate(degrees)); 

















void InvertMatrices(IEnumerable<Matrix> matrices) 


{ 
Parallel.ForEach(matrices, (matrix, state) => 
{ 
if (!matrix.IsInvertible) 
state. Stop(); 
else 
matrix.Invert(); 
]); 
} 


更 常见 的 情况 是 可 以 取消 并 行 循环 ， 这 与 结束 循环 不 同 。 结 束 (stop) 循环 是 在 循环 内 部 
进行 的 ， 而 取消 (cancel) 循环 是 在 循环 外 部 进行 的 。 例 如 ， 点 击 “ 取 消 ” 按 钮 可 以 取消 
一 个 CancellationTokenSource， 以 取消 并 行 循 环 ， 方 法 如 下 : 





void RotateMatrices(IEnumerable<Matrix> matrices, float degrees, 
CancellationToken token) 


{ 
Parallel.ForEach(matrices, 
new ParallelOptions { CancellationToken = token }, 
matrix => matrix.Rotate(degrees)); 
} 








Ba 











需要 注意 的 是 ， 每 个 并 行 任务 可 能 都 在 不 同 的 线程 中 运行 ， 
下 面 的 例子 反 转 每 个 矩阵 并 统计 无 法 反 转 的 矩阵 数量 : 


此 必须 保护 对 共享 的 状态 。 


// 注意 ， 这 不 是 最 高 效 的 实现 方式 。 ， 
// 只 是 举 个 例子 ， 说 明 用 锁 来 保护 共享 状态 。 
int InvertMatrices(IEnumerable<Matrix> matrices) 


{ 




















object mutex = new object(); 
int nonInvertibleCount = 0; 
Parallel.ForEach(matrices, matrix => 
€ 

if (matrix.IsInvertible) 


{ 


matrix.Invert(); 





else 
{ 
lock (mutex) 
{ 
++nonInvertibleCount; 
3 
} 
}); 
return nonInvertibleCount; 
} 
外 * 八 
讨论 


Parallel.ForEach 方法 可 以 对 一 系列 值 进行 并 行 处 理 。 还 有 一 个 类 似 的 解决 方案 ， 就 是 使 
用 PLINQ (并 行 LINQ)。PLINQ 的 大 部 分 功能 和 Parallel 类 一 样 ， 并 且 采 用 与 LINQ 类 
似 的 语法 。Paratlel 类 和 PLINQ 之 间 有 一 个 区 别 : PLINQ 假设 可 以 使 用 计算 机 内 所 有 的 
CPU 核 ， 而 Paratlel 类 则 会 根据 CPU 状态 的 变化 动态 地 调整 。 





Parallel.ForEach 是 并 行 版 本 的 foreach 循环 。pParalLtLet 类 也 提供 了 并 行 版 本 的 for 循环 ， 
即 Parallel.For 方法 。 如 果 有 多 个 数组 的 数据 ， 并 且 它 们 采用 了 相同 的 索引 ，Parallel. 
For 就 特别 适用 。 


参阅 
3.2 节 介 绍 如 何 对 一 批 数 据 进行 并 行 地 聚合 ， 包 括 累 加 和 、 平 均值 。 





3.5 节 介 绍 PLINQ 的 基础 知识 。 
第 9 章 介 绍 取消 操作 的 方法 。 
4 二 征 x 人 
3.2 ”并 行 聚合 
问题 
在 并 行 操作 结束 时 ， 需 要 聚合 结果 ， 包 括 累 加 和 、 平 均值 等 。 
解决 方案 
Parallel 类 通过 局 部 值 (local value) 的 概念 来 实现 聚合 ， 局 部 值 就 是 只 在 并 行 循环 内 部 存 
在 的 变量 。 这 意味 着 循环 体 中 的 代码 可 以 直接 访问 值 ， 不 需要 担心 同步 问题 。 循 环 中 的 代 


码 使 用 LocaLFinalLtLy 委托 来 对 每 个 局 部 值 进 行 聚合 。 需 要 注意 的 是 ，LocaLFinalLLy 委托 需 
要 以 同步 的 方式 对 存放 结果 的 变量 进行 访问 。 下 面 是 一 个 并 行 求 累 加 和 的 例子 ; 
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// 注意 ， 这 不 是 最 高 效 的 实现 方式 。 
// 只 是 举 个 例子 ， 说 明 用 锁 来 保护 共享 状态 。 
static int ParallelSum(IEnumerable<int> values) 


{ 





























object mutex = new object(); 

int result = 0; 

Parallel.ForEach(source: values, 
localInit: () => 0， 
body: (item, state, localValue) => localValue + item, 
localFinally: localValue => 


lock (mutex) 
result += localValue; 


}); 


return result; 


} 
并 行 LINQ 对 聚合 的 支持 ， 比 Parallel 类 更 加 顺手 : 


static int ParallelSum(IEnumerable<int> values) 


{ 
} 


好 吧 ， 那 只 是 雕 虫 小 技 ， 因 为 PLINQ 本 身 就 支持 很 多 常规 操作 (例如 求 累 加 和 和 )。PLINQ 
也 可 通过 Aggregate 实现 通用 的 聚合 功能 : 


return values.AsParallel().Sum(); 





static int ParallelSum(IEnumerable<int> values) 


{ 
return valuyes.AsParallel().Aggregatel( 
seed: 0， 
func: (sum, item) => sum + item 
); 
} 
* 和 
讨论 


如 果 程 序 中 已 经 在 使 用 Paratlel 类 ， 则 可 使 用 它 的 聚合 功能 。 否 则 ， 大 多 数 情况 下 
PLINQ 对 聚合 的 支持 更 有 表现 力 ， 代 码 也 更 少 。 


参阅 

3.5 节 介 绍 PLINQ 的 基础 知识 。 
/A *» 

3.3 ”并 行 调用 


问题 


需要 并 行 调 用 一 批 方 法 ， 并 且 这 些 方法 (大 部 分 ) 是 互相 独立 的 。 








解决 方案 
parattet 类 有 一 个 简单 的 成 员 Invoke， 就 可 用 于 这 种 场合 。 下 面 的 例子 将 一 个 数组 分 为 两 
半 ， 并 且 分 别 独立 处 理 ， 


static void ProcessArray(double[] array) 


{ 
ParaLLeL.Invoke( 
() => ProcessPartialArray(array, 0, array.Length / 2)， 
() => ProcessPartialArray(array, array.Length / 2, array.Length) 
); 
} 


static void ProcessPartialArray(double[] array, int begin, int end) 


// 计算 密集 型 的 处 理 过 程 .…. 





} 

















如 果 在 运行 之 前 都 无 法 确定 调用 的 数量 ， 就 可 以 在 Parallel.Invoke 函数 中 输入 一 个 委托 
数组 : 





static void DoAction20Times(Action action) 

{ 
Action[] actions = Enumerable.Repeat(action, 20).ToArray(); 
Parallel.Invoke(actions); 


} 
就 像 Paratlel 类 的 其 他 成 员 一 样 ，Paratlel.Invoke 也 支持 取消 操作 : 














static void DoAction20Times(Action action, CancellationToken token) 


{ 
Action[] actions = Enumerable.Repeat(action, 20).ToArray(); 
Parallel.Invoke(new ParallelOptions { CancellationToken = token }, actions); 


讨论 

对 于 简单 的 并 行 调用 ，Parallel.Invoke 是 一 个 非常 不 错 的 解决 方案 。 然 而 在 以 下 两 种 情 
况 中 使 用 Paratlel.Invoke 并 不 是 很 合适 : 要 对 每 一 个 输入 的 数据 调用 一 个 操作 ( 改 用 
Parallel.Foreach)， 或 者 每 一 个 操作 产生 了 一 些 输 出 ( 改 用 并 行 LINQ)。 





参阅 


3.1 市 介绍 Parallel.ForEach， 它 对 每 个 数据 项 调用 一 个 操作 。 





3.5 节 介 绍 PLINQ。 
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3.4 动态 并 行 


问题 
并 行 任务 的 结构 和 数量 要 在 运行 时 才能 确定 ， 这 是 一 种 更 复杂 的 并 行 编程 。 


解决 方案 
任务 并 行 库 (TPL) 是 以 Task 类 为 中 心 构建 的 。Task 类 的 功能 很 强大 ，Parallel 类 和 并 行 
LINQ 只 是 为 了 使 用 方便 ， 从 而 对 Task 类 进行 了 封装 。 实 现 动 态 并 行 最 简单 的 做 法 就 是 直 
接 使 用 Task 类 。 

















下 面 的 例子 对 二 又 树 的 每 个 节点 进行 处 理 ， 并 且 该 处 理 是 很 耗资 源 的 。 二 又 树 的 结构 在 运 
行 时 才能 确定 ， 因 此 非常 适合 采用 动态 并 行 。Traverse 方法 处 理 当 前 节点 ， 然 后 创建 两 个 
子 任务 ， 每 个 子 任务 对 应 一 个 子 市 点 (本 例 中 ,假定 必须 先 处 理 父 市 点， 然后 才能 处 理子 
节点 )。ProcessTree 方法 启动 处 理 过 程 ， 创 建 一 个 最 高 层 的 父 任务 ， 并 等 待 任务 完成 : 






































void Traverse(Node current) 


{ 
DoExpensiveActionOnNode(current); 
if (current.Left != nuLL) 
€ 
Task.Factory.StartNew(() => Traverse(current.Left), 
CancellationToken.None, 
TaskCreationOptions.AttachedToParent, 
TaskScheduler .Default); 
} 
if (current.Right != null) 
E 
Task.Factory.StartNew(() => Traverse(current.Right), 
CancellationToken.None, 
TaskCreationOptions.AttachedToParent, 
TaskScheduler .Default); 
} 
} 
public void ProcessTree(Node root) 
{ 
var task = Task.Factory.StartNew(() => Traverse(root), 
CancellationToken .None, 
TaskCreationOptions.None, 
TaskScheduler .Default); 
task.Wait(); 
} 


如 果 这 些 任务 没有 “ 父 / 子 ”关系 ， 那 可 以 使 用 任务 延续 (continuation) 的 方法 ， 安 排 任务 
一 个 接着 一 个 地 运行 。 这 里 continuation 是 一 个 独立 的 任务 ， 它 在 原始 任务 结束 后 运行 : 








Task task = Task.Factory.StartNew( 
() => Thread.Sleep(TimeSpan.FromSeconds(2)), 
CanceLLationToken.None， 
TaskCreationOptions.None, 
TaskScheduler .Default); 

Task continuation = task.ContinueWith( 
t => Trace.NriteLine("Task is done"), 
CancellationToken.None, 
TaskContinuationOptions.None, 
TaskScheduler .Default); 

// 对 continuation 来 说 ， 参 数 “t” 相 当 于 “task” 


讨论 
上 面 的 例子 使 用 了 CancellationToken.None 和 TaskSscheduLer.DefauLt。 取 消 令 牌 (cancella- 


tion token) 在 9.2 节 介 绍 ， 任 务 调度 器 (task scheduler) 在 12.3 节 介 绍 。 最 好 在 StartNew 
和 ContinueWith 中 明确 指定 用 TaskScheduler。 








在 动态 并 行 中 ， 通 常 以 “ 父 / 子 ” 的 方式 对 任务 进行 安排 ， 但 也 不 是 必须 要 这 么 做 。 把 每 
个 新 任务 存储 在 线程 安全 的 集合 中 ， 然 后 用 Task.WaitAll 等 待 所 有 任务 完成 ， 这 种 做 法 同 
样 可 行 。 














在 并 行 处 理 中 使 用 Task 类 ， 和 在 异步 处 理 中 使 用 完全 不 同 。 下 面 会 详细 
解释 。 

















在 并 发 编程 中 ，Task 类 有 两 个 作用 : 作为 并 行 任务 ， 或 作为 异步 任务 。 并 行 任务 可 以 使 用 


阻塞 的 成 员 函 数 ， 例 如 Task.wait、Task.Result、Task.WaitAll 和 Task.waitAny。 并 行 任 


务 通常 也 使 用 AttachedToParent 来 建立 任务 之 间 的 “ 父 / 子 ”关系 。 并 行 任务 的 创建 需要 
用 Task.Run 或 者 Task.Factory.StartNew。 








相反 ， 异 步 任 务 应 该 避免 使 用 阻塞 的 成 员 函 数 ， 而 应 该 使 用 await、Task.WhenAll 和 Task. 
WhenAny。 异 步 任务 不 使 用 AttachedToParent， 但 可 以 通过 await 另 一 个 任务 ， 建 立 一 种 隐 
式 的 “ 父 / 子 ”关系 。 


参阅 
3.3 节 介 绍 并 行 调用 事先 明确 的 一 批 方法 。 
3.5 并行 LINQ 


问题 
需要 对 一 批 数 据 进 行 并 行 处 理 ， 生 成 男 外 一 批 数 据 ， 或 者 对 数据 进行 统计 。 
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解决 方案 

大 部 分 开发 者 对 LINQ 比较 熟悉 ，LINQ 可 以 实现 在 序列 上 ” 拉 取 “数据 的 运算 。 并 行 
LINQ (PLINQ) 扩展 了 LINQ， 以 支持 并 行 处 理 。 

PLINQ 非常 适用 于 数据 流 的 操作 ， 一 个 数据 队列 作为 输入 ， 一 个 数据 队列 作为 输出 。 下 面 
简单 的 例子 将 序列 中 的 每 个 元 素 都 乘 以 2 (实际 应 用 中 ， 计 算 工作 量 要 大 得 多 ) : 


static IEnumerable<int> MultiplyBy2(IEnumerable<int> values) 


{ 
3 


按照 并 行 LINQ 的 默认 方式 ， 这 个 例子 中 输出 数据 队列 的 次 序 是 不 固定 的 。 也 可 以 指明 要 
求 保持 原来 的 次 序 。 下 面 的 例子 也 是 并 行 执行 的 ， 但 保留 了 数据 的 原 有 次 序 : 


return values.AsParallel().Select(item => item * 2); 





static IEnumerable<int> MultiplyBy2(IEnumerable<int> values) 


{ 
} 


并 行 LINQ 的 另 一 个 常规 用 途 是 用 并 行 方式 对 数据 进行 聚合 或 汇总 。 下 面 的 代码 实现 了 并 
行 的 累加 求 和 : 


return values.AsParallel().AsOrdered().Select(item => item * 2); 





static int ParallelSum(IEnumerable<int> values) 


{ 
return values.AsParallel().Sum(); 

} 

讨论 


Parallel 类 可 适用 于 很 多 场合 ， 但 是 在 做 聚合 或 进行 数据 序列 的 转换 时 ，PLINQ 的 代码 更 
加 简洁 。 有 一 点 需要 注意 ， 相 比 PLINQ，Parallel 类 与 系统 中 其 他 进程 配合 得 更 好 。 如 果 
在 服务 器 上 做 并 行 处 理 ， 这 一 点 尤其 需要 考虑 。 


PLINQ 为 各 种 各 样 的 操作 提供 了 并 行 的 版 本 ， 包 括 过 滤 (Where)、 投 影 (Select) 以 及 各 
种 聚合 运算 ， 例 如 Sum、Average 和 更 通用 的 Aggregate。 一 般 来 说 ， 对 常规 LINQ 的 所 有 
操作 都 可 以 通过 并 行 方式 对 PLINQ 执行 。 正 因为 如 此 ， 如 果 准 备 把 已 有 的 LINQ 代码 改 为 
并 行 方式 ，PLINQ 是 一 种 非常 不 错 的 选择 。 






































参阅 
3.1 节 介 绍 利用 Paratlel 类 处 理 序 列 中 每 个 元 素 的 方法 。 

















9.5 市 介绍 如 何 取 消 一 个 PLINQ 查询 。 
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TPL 数据 流 (dataflow) 库 的 功能 很 强大 ， 可 用 来 创建 网 格 (mesh) 和 管道 (pipleline)， 
并 通过 它们 以 异步 方式 发 送 数据 。 数 据 流 的 代码 具有 很 强 的 “声明 式 编程 ”风格 。 通 常 要 
先 完整 地 定义 网 格 ， 然 后 才能 开始 处 理 数据 ， 最 终 让 网 格 成 为 一 个 让 数据 流通 的 体系 架 
构 。 这 种 编程 风格 会 让 你 觉得 有 些 不 适应 ,但 一 旦 远 过 这 一 步 ， 你 会 发 觉 数据 流 适 用 于 许 
多 场合 。 











每 个 网 格 由 各 种 互相 链接 的 数据 流 块 (block) 构成 。 独 立 的 块 比较 简单 ， 只 负责 数据 处 理 
中 某 个 单独 的 步骤 。 当 块 处 理 完 它 的 数据 后 ， 就 会 把 数据 传递 给 与 它 链接 的 块 。 

















使 用 TPL 数据 流 之 前 , 需要 在 程序 中 安装 一 个 NuGet 包 : Microsoft.Tpl.Dataflow。 各 种 平 
台 对 TPL 数据 流 库 的 支持 情况 见 表 4-1。 


表 4-1: 支持 TPL 数 据 流 的 平台 

胖 台 数据 流 
.NET 4.5 

.NET 4.0 

Mono 10S/Droid 





Windows Store 

Windows Phone Apps 8.1 
Windows Phone SL 8.0 
Windows Phone SL 7.1 
Silverlight 5 x 
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4.1 链接 数据 流 块 
问题 

创建 网 格 时 ， 需 要 把 数据 流 块 互相 链接 起 来 。 
解决 方案 


TPL 数据 流 库 提供 的 块 只 有 一 些 基本 的 成 员 ， 很 多 实用 的 方法 实际 上 是 扩展 方法 。 这 里 我 
们 来 看 LinkTo 方法 : 





var multiplyBlock 
var subtractBlock 


new TransformBlock<int, int>(item => item * 2); 
new TransformBlock<int, int>(item => item - 2); 








// 建立 链接 后 ， 从 multiplyBlock 出 来 的 数据 将 进入 subtractBLock。 
multiplyBlock.LinkTo(subtractBlock); 
默认 情况 下 ， 链 接 的 数据 流 块 只 传递 数据 ， 不 传递 完成 情况 (或 出 错 信息 )。 如 果 数 据 流 
是 线性 的 (例如 管道 )， 一般 需 要 传递 完成 情况 。 要 实现 完成 情况 (和 出 错 信 息 ) 的 传递 ， 
可 以 在 链接 中 设置 PropagateCompletion 属性 : 


var multiplyBlock 
var subtractBlock 


new TransformBlock<int, int>(item => item * 2); 
new TransformBlock<int, int>(item => item - 2); 


var options = new DataflowLinkOptions { PropagateCompletion = true }; 
multiplyBlock.LinkTo(subtractBlock, options); 


// 第 一 个 块 的 完成 情况 自动 传递 给 第 二 个 块 。 
multiplyBlock.Complete(); 
await subtractBlock.Completion; 


讨论 
一 旦 建立 了 链接 ， 数 据 就 会 自动 从 源 块 传递 到 目标 块 。 如 果 设 置 了 PropagateCompletion 
属性 ， 情 况 完 成 的 同时 也 会 传递 数据 。 在 管道 的 每 个 节点 上 ， 当 出 错 的 块 把 错误 信息 传递 
给 下 一 块 时 ， 它 会 把 错误 信息 封装 进 AggregateException 对 象 。 因 此 ， 如 果 传 递 完成 情况 
的 管道 很 长 ， 错 误 信 息 就 会 被 身 套 在 很 多 个 AggregateException 实例 中 。 在 这 种 情形 下 ， 
AggregateException 有 几 个 成 员 (例如 Flatten) 就 可 以 进行 错误 处 理 了 。 

链接 数据 流 块 的 方式 有 很 多 种 ， 可 以 在 网 格 中 包含 分 又 、 连 接 、 其 至 循环 。 不 过 在 大 多 数 
情况 下 ， 线 性 的 管道 就 足够 管用 了 。 本 书 主 要 介绍 管道 (此 外 简单 地 介绍 一 下 分 又 )， 更 
多 的 高 级 内 容 则 超出 了 本 书 范 围 。 
























































利用 DatafLowLinkoptions 类 ， 可 以 对 链接 设置 多 个 不 同 的 参数 (例如 前 面 用 到 的 
PropagateCompletion 参数 )。 另 外 ， 可 以 在 重 载 的 LinkTo 方法 中 设置 断言 ， 形 成 一 个 数 
据 通 行 的 过 滤器 。 数 据 被 过 滤器 拦截 时 也 不 会 被 删除 。 通 过 过 滤器 的 数据 会 继续 下 一 步 流 
程 ， 被 过 滤器 拦截 的 数据 也 会 尝试 从 其 他 链接 通过 ， 如 果 所 有 链接 都 无 法 通过 ， 则 会 留 在 
原来 的 块 中 。 




















参阅 

4.2 市 介绍 如 何 沿 着 链接 传递 出 错 信 息 。 

4.3 市 介绍 如 何 删 除 块 之 间 的 链接 。 

7.7 节 介 绍 如 何 将 数据 流 块 与 Rx 可 观察 流 链接 。 


4.2 ”传递 出 错 信息 


问题 
需要 处 理 数 据 流 网 格 中 发 生 的 错误 。 


解决 方案 

如 果 数 据 流 块 内 的 委托 抛 出 错误 ， 这 个 块 就 进入 故障 状态 。 一 旦 数据 流 块 进入 故障 状态 ， 
就 会 删除 所 有 的 数据 (并 停止 接收 新 数据 )。 该 数据 流 块 将 不 会 生成 任何 新 数据 。 下 面 的 
代码 中 ， 第 一 个 值 引发 了 一 个 错误 ， 第 二 个 值 被 直接 删除 : 


























var block = new TransformBlock<int, int>(item => 
{ 
if (item == 1) 
throw new InvalidOperationException("Blech."); 
return item * 2; 


]); 
block.Post(1); 
block.Post(2); 


用 await 调用 它 的 Completion 属性 ， 即 可 捕获 数据 流 块 的 错误 。Completion 属性 返回 
任务 ,一 旦 数据 流 块 执行 完成 ， 这 个 任务 也 完成 。 如 果 数 据 流 块 出 错 ， eon 








try 
{ 


var block = new TransformBlock<int, int>(item => 


if (item == 1) 
throw new InvalidOperationException("Blech."); 
return item * 2; 
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]); 
block.Post(1); 
await block.Completion; 

















} 
catch (InvalidOperationException) 
{ 
// 这 里 捕获 异常 。 
} 

















如 果 用 PropagateCompletion 这 个 参数 传递 完成 情况 ， 错 误 信 息 也 会 被 传递 。 只 不 过 这 个 异常 
是 被 封装 在 AggregateException 类 中 传递 给 下 一 个 块 。 下 面 的 例子 中 ， 程 序 在 管道 的 末尾 捕 
歼 到 了 异常 。 这 说 明 ， 如 果 异 常 是 从 前 面 的 块 传 来 的 ， 程 序 就 会 捕获 到 AggregateException: 


try 
{ 


var multiplyBlock = new TransformBlock<int, int>(item => 


if (item == 1) 
throw new InvalidOperationException("Blech."); 

return item * 2; 
]); 
var subtractBlock = new TransformBlock<int, int>(item => item - 2); 
multiplyBlock.LinkTo(subtractBlock, 

new DataflowLinkOptions { PropagateCompletion = true }); 
multiplyBlock.Post(1); 
await subtractBlock.Completion; 


catch (AggregateException) 











// 这 里 捕获 异常 。 








} 


数据 流 块 收 到 传 过 来 的 出 错 信息 后 ， 即 使 它 已 经 被 封装 在 AggregateException， 仍 会 用 
AggregateException 进行 封装 。 如 果 在 管道 的 前 面部 分 发 生 错误 ， 经 过 了 多 个 链接 后 才 被 
发 现 ， 这 个 原始 错误 就 会 被 AggregateException 封装 很 多 层 。 这 时 用 AggregateException. 
Flatten 方法 可 以 简化 错误 处 理 过 程 。 


讨论 

思考 一 下 这 个 问题 ， 在 构建 了 网 格 (或 管道 ) 后 怎么 处 理 错误 。 对 于 最 简单 的 情况 ， 最 好 
是 把 错误 传递 下 去 ， 等 到 最 后 再 作 一 次 性 处 理 。 对 于 更 复杂 的 网 格 ， 在 数据 流 完成 后 需要 
检查 每 一 个 数据 流 块 。 





















































参阅 
4.1 节 介 绍 如 何 链接 数据 流 块 。 
4.3 市 介绍 如 何 断 开 数 据 流 块 的 链接 。 





4.3 上 断 开 链接 

问题 

要 在 处 理 的 过 程 中 修改 数据 流 结构 。 这 是 一 种 高 级 应 用 ， 很 少 会 用 到 。 
解决 方案 


可 以 随时 对 数据 流 块 建立 链接 或 断 开 链 接 。 数 据 在 网 格 中 的 自由 传递 ， 不 会 受 此 影响 。 建 
立 或 断 开 链接 时 ， 线 程 都 是 完全 安全 的 。 


在 创建 数据 流 块 之 间 的 链接 时 ,保留 LinkTo 方法 返回 的 IDisposable 接口 。 想 断 开 它们 的 
链接 时 ， 只 需 释 放 该 接口 : 

















var multiplyBlock = new TransformBlock<int, int>(item => item * 2); 
var subtractBlock = new TransformBlock<int, int>(item => item - 2); 


IDisposable link = multiplyBlock.LinkTo(subtractBlock); 
multiplyBlock.Post(1); 
multiplyBlock.Post(2); 


// 断 开 数据 流 块 的 链接 。 

// 前 面 的 代码 中 ， 数 据 可 能 已 经 通过 链接 传递 过 去 ， 也 可 能 还 没有 。 
// 在 实际 应 用 中 ， 考 虑 使 用 代码 块 ， 而 不 是 调用 Dispose。 
link.Dispose(); 


讨论 

除非 能 保证 链接 是 空间 的 ， 否 则 在 断 开 数 据 流 块 的 链接 时 就 会 出 现 莞 态 条 件 (race 
condition) 。 但 是 ， 通 常 不 需要 担心 这 类 竞 态 条 件 。 数 据 要 么 在 链接 断 开 之 前 就 已 经 传递 到 
下 一 块 ， 要么 就 永远 不 会 传递 。 这 些 况 态 条 件 不 会 重复 出 现 数据 ， 也 不 会 丢失 数据 。 


断 开 链接 是 一 个 高 级 应 用 ， 但 它 仍 能 用 于 一 些 场合 。 举 个 例子 ， 在 链接 建立 后 是 无 法 修改 
过 滤器 的 ， 要 修改 一 个 已 有 链接 的 过 滤器 ， 必 须 先 断 开 旧 链接 ， 然 后 用 新 的 过 滤器 建立 新 
链接 (可 以 把 DataflowLinkOptions.Append 设 为 faLtse)。 另 外 ， 要 暂停 数据 流 网 格 运行 的 
话 ， 可 断 开 一 个 关键 链接 。 























参阅 
4.1 节 介 绍 如 何在 数据 流 块 之 间 建 立 链接 。 
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4.4 限制 流量 
问题 
需要 在 数据 流 网 格 中 进行 分 又 ， 并 且 希 望 数据 流量 能 在 各 分 支 之 间 平 衡 。 


解决 方案 

默认 情况 下 ， 数 据 流 块 生成 输出 的 数据 后 ， 会 检查 每 个 链接 (按照 创建 的 次 序 )， 逐 个 地 
尝试 通过 链接 传递 数据 。 同 样 ， 默 认 情 况 下 ， 每 个 数据 流 块 会 维护 一 个 输入 缓冲 区 ， 在 处 
理 数据 之 前 接收 任意 数量 的 数据 。 


有 分 又 时 ， 一 个 源 块 链 接 了 两 个 目标 块 ， 上 述 做 法 就 会 产生 问题 第 一 个 目标 块 会 不 停 地 
缓冲 数据 ， 第 二 个 目标 块 就 永远 没有 机 会 得 到 数据 。 这 个 问题 的 解决 办 法 是 使 用 数据 流 块 
的 BoundedCapacity 属性 ， 来 限制 目标 块 的 流量 (throttling)。BoundedCapacity 的 默认 设置 
是 DataflowBlockOptions.Unbounded， 这 会 导致 第 一 个 目标 块 在 还 来 不 及 处 理 数 据 时 就 得 对 
所 有 数据 进行 缓冲 了 。 


BoundedCapacity 可 以 是 大 于 0 的 任何 数值 (当然 也 可 以 是 DataflowBlockOptions.Unbounded)。 
只 要 目标 块 来 得 及 处 理 来 自 源 块 的 数据 ， 将 这 个 参数 设 为 1 就 足够 了 : 


var sourceBLock = new BufferBlock<int>(); 

var options = new DataflowBlockOptions { BoundedCapacity = 1 }; 
var targetBLockA = new BufferBlock<int>(options); 

var targetBLockB = new BufferBlock<int>(options); 






































sourceBLock.LinkTo(targetBLockA) ; 
sourceBlock.LinkTo(targetBlockB); 


讨论 

限 流 可 用 于 分 又 的 负载 平衡 ， 但 也 可 用 在 任何 限 流行 为 中 。 例 如 ， 在 用 IO 操作 的 数据 填 
充 数 据 流 网 格 时 ， 可 以 设置 数据 流 块 的 BoundedCapacity 属性 。 这 样 ， 在 网 格 来 不 及 处 理 
数据 时 ， 就 不 会 读 取 过 多 的 IO 数据 ， 网 格 也 不 会 缓存 所 有 数据 。 

参阅 

4.1 节 介 绍 建立 数据 流 块 之 间 的 链接 。 


4.5 ”数据 流 块 的 并 行 处 理 


问题 


想 对 数据 流 网 格 进行 并 行 处 理 。 
































解决 方案 

默认 情况 下 每 个 数据 流 块 是 互相 独立 的 。 将 两 个 数据 流 块 链接 起 来 后 ， 它 们 也 是 独立 运行 
的 。 因 此 每 个 数据 流 网 格 本 身 就 有 并 行 特 性 。 

如 果 想 更 进一步 ， 例 如 某 个 特定 的 数据 流 块 的 计算 量 特别 大 ， 那 就 可 以 设置 MaxDegreeof 
Parallelism 参数 ， 使 数据 流 块 在 处 理 输入 的 数据 时 采用 并 行 的 方式 。MaxDegreeOf 
Parallelisn 的 默认 值 是 1， 因 此 每 个 数据 流 块 同 时 只 能 处 理 一 块 数据 。 


























MaxDegree0fParallelism 可 以 设 为 DatafLowBLockOptions.Unbounded 或 任何 大 于 0 的 值 。 下 
面 的 例子 允许 任意 数量 的 任务 ， 来 同时 对 数据 进行 倍增 : 








var multiplyBlock = new TransformBlock<int, int>( 

item => item * 2， 

new ExecutionDataflowBlockOptions 

{ 

MaxDegreeOfParallelism = DataflowBlockOptions.Unbounded 

} 
); 
var subtractBlock = new TransformBlock<int, int>(item => item - 2); 
multiplyBlock.LinkTo(subtractBlock); 


讨论 

利用 MaxDegree0fParallelisnm 参数 ， 就 可 以 很 容易 地 在 数据 流 块 中 实现 并 行 处 理 。 而 真正 
的 难点 ， 在 于 找 出 哪些 数据 流 块 需要 并 行 处 理 ， 有 一 个 办 法 是 在 调试 时 暂停 数据 流 的 运 
行 ， 在 调试 器 中 查看 等 待 的 数据 项 的 数量 (就 是 还 没有 被 数据 流 块 处 理 的 数据 项 )。 如 果 
等 待 的 数据 项 很 多 ， 就 表明 需要 进行 重 构 或 并 行 化 处 理 。 


在 数据 流 块 进行 异步 处 理 时 ，MaxDegree0fParallelism 参 数 也 会 发 挥 作用 。 这 时 ， 
MaxDegreeOfParallelisnm 参数 代表 的 是 并 发 的 层次 ， 即 一 定数 量 的 楷 (slot)。 在 数据 流 块 
开始 处 理 数据 项 之 际 ， 每 个 数据 项 就 会 占用 一 个 槽 。 只 有 当 整 个 异步 处 理 过 程 完 成 后 ， 才 
参阅 
4.1 节 介 绍 链接 数据 流 块 。 

Ey hy ~ 
4.6 ”创建 自 定义 数据 流 块 
问题 


希望 一 些 可 重用 的 程序 逻辑 在 自 定义 数据 疲 块 中 使 用 。 这 有 助 于 创建 更 大 的 、 包 含 复杂 膛 
辑 的 数据 流 快 。 
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解决 方案 

通过 使 用 Encapsulate 方法 ， 可 以 取出 数据 流 网 格 中 任何 具有 单一 输入 块 和 输出 块 的 部 分 。 
Encapsulate 方法 会 利用 这 两 个 端点 ， 创 建 一 个 单独 的 数据 流 块 。 开 发 者 得 自己 负责 端点 
之 间 数 据 的 传递 以 及 完成 情况 。 下 面 的 代码 利用 两 个 数据 流 块 创建 了 一 个 自 定义 数据 流 
块 ， 并 实现 了 数据 和 完成 情况 的 传递 : 








IPropagatorBlock<int, int> CreateMyCustomBlock() 


var multiplyBlock = new TransformBlock<int, int>(item => item * 2); 
var addBlock = new TransformBlock<int, int>(item => item + 2); 
var divideBlock = new TransformBlock<int, int>(item => item / 2); 


var flowCompletion = new DataflowLinkOptions { PropagateCompletion = true }; 
multiplyBlock.LinkTo(addBlock, flowCompletion); 
addBlock.LinkTo(divideBlock, flowCompletion); 


return DataflowBlock.Encapsulate(multiplyBlock, divideBlock); 


讨论 
在 把 一 个 网 格 封装 成 一 个 自 定 义 数 据 流 块 时 ， 得 考虑 一 下 对 外 提供 什么 类 型 的 参数 ， 考 虑 
每 个 块 参数 应 该 怎样 传递 进 内 部 的 网 格 〈 或 不 传递 ) 。 在 很 多 情况 下 ， 有 些 块 参数 是 不 适 
合 的 ， 或 者 是 没有 意义 的 。 基 于 这 个 原因 ， 创 建 自 定义 数据 流 块 时 ， 通 常 得 自行 定义 参 
数 ， 而 不 是 沿用 DataflowBlockOptions 参数 。 














DataflowBlock.Encapsulate 只 会 封装 只 有 一 个 输入 块 和 一 个 输出 块 的 网 格 。 如 果 一 个 可 
重用 的 网 格 带 有 多 个 输入 或 输出 ， 就 应 该 把 它 封装 进 一 个 自 定 义 对 象 ， 并 以 属性 的 形式 
对 外 暴露 出 这 些 输 入 和 输出 ， 输 入 的 属性 类 型 是 ITargetBLock<T>， 输 出 的 属性 类 型 是 


IReceivableSourceBlock<T>。 





前 面 的 例子 都 采用 Encapsulate 来 创建 自 定义 数据 流 块 。 开 发 者 也 可 以 自行 实现 数据 流 的 接 
口 ， 但 技术 难度 很 大 。 创 建 自 定义 数据 流 块 的 高 级 技术 ， 可 参阅 微软 公司 发 布 的 有 关 文 章 。 
参阅 

4.1 节 介 绍 了 链接 数据 流 块 。 

4.2 节 介 绍 了 通过 块 的 链接 传递 出 错 信 息 。 
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LINQ 是 对 序列 数据 进行 查询 的 一 系列 语言 功能 。 内 置 的 LINQto Objects (基于 
IEnumerable<T>) 和 LINQ to Entities (基于 IQueryableT>) 是 两 个 最 常用 的 LINQ 提供 
者 。 另 外 还 有 很 多 提供 者 ， 并 且 大 多 数 都 采用 相同 的 基本 架构 。 查 询 是 延 后 执行 (lazily 
evaluated) 的 ， 只 有 在 需要 时 才 会 从 序列 中 获取 数据 。 从 概念 上 讲 ， 这 是 一 种 拉 取 模式 。 
在 查询 过 程 中 数据 项 是 被 逐个 拉 取 出 来 的 。 


Reactive Extensions (Rx) 把 事件 看 作 是 依次 到 达 的 数据 序列 。 因 此 ， 将 Rx 认 作 是 LINQ 
to events (基于 I0bservable<T>) 也 是 可 以 的 ， 它 与 其 他 LINQ 提供 者 的 主要 区 别 在 于 ， 
Rx 采用 “推送 ”模式 。 就 是 说 ，Rx 的 查询 规定 了 在 事件 到 达 时 程序 该 如 何 响应 。Rx 在 
LINQ 的 基础 上 构建 ， 增 加 了 一 些 功能 强大 的 操作 符 ， 作 为 扩展 方法 。 


本 章 介 绍 一 些 更 常用 的 Rx 操作 。 需 要 注意 的 是 ， 所 有 的 LINQ 操作 都 可 以 在 Rx 中 使 用 。 
从 概念 上 看 ， 过 滤 (Where)、 投 影 (Select) 等 简单 操作 ， 和 其 他 LINQ 提供 者 的 操作 是 
一 样 的 。 本 章 不 介绍 那些 常见 的 LINQ 操作 ， 而 将 重点 放 在 Rx 在 LINQ 基础 上 增加 的 新 
功能 ， 尤 其 是 与 时 间 有 关 的 功能 。 


要 使 用 Rx， 需 要 在 应 用 中 安装 一 个 NuGet 包 Rx-Main。 支 持 Reactive Extensions 的 平台 非 
常 丰富 (参见 表 5-1)。 





















































表 5-1: 支持 Reactive Extensions 的 平台 





平 台 Rx 支 持 情况 
.NET 4.5 这 
.NET 4.0 最 
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平 台 Rx 支 持 情况 
Mono iOS/Droid 





Windows Store 

Windows Phone Apps 8.1 
Windows Phone SL 8.0 
Windows Phone SL 7.1 
Silverlight 5 


5.1 转换 .NET 事 件 


问题 
把 一 个 事件 作为 Rx 输入 流 ， 每 次 事件 发 生 时 通过 OnNext 生成 数据 。 


解决 方案 


Observable 类 定义 了 一 些 事 件 转换 器 。 大 部 分 .NET 框架 事件 与 FromEventPattern 兼容 ， 
对 于 不 遵循 通用 模式 的 事件 ， 需 要 改 用 FromEvent。 




















二 





地 





FromEventPattern 最 适合 使 用 委托 类 型 为 EventHandler<T> 的 事件 。 很 多 较 新 框架 
件 都 采用 了 这 种 委托 类 型 。 例 如 ，Progress<T> 类 定义 了 事件 ProgressChanged， 0 
的 委托 类 型 就 是 EventHandler<T>， 因 此 ， 它 就 很 容易 被 封装 到 FromEventPattern: 


村 





var progress = new Progress<int>(); 
var progressReports = Observable.FromEventPpattern<int>( 

handler => progress.ProgressChanged += handler, 

handler => progress.ProgressChanged -= handler); 
progressReports.Subscribe(data => Trace.WriteLine("OnNext:" + data.EventArgs)); 


请 注意 ，data.EventArgs 是 强 类 型 的 int。FromEventPattern 的 类 型 参数 (上 例 中 为 int) 


与 EventHandler<T> 的 TT 相同 。Rx 用 FromEventPattern 中 的 两 个 Lambda 参数 来 实现 订阅 
和 退 订 事件 。 








浴 


较 新 的 UI 框架 采用 EventHandLer<T>， 可 以 很 方便 地 应 用 在 FromEventPattern 中 。 但 是 有 
些 较 旧 的 类 常 为 每 个 事件 定义 不 同 的 委托 类 型 。 这 些 事件 也 能 在 FromEventPattern 中 使 用 ， 
但 需要 做 一 些 额 外 的 工作 。 例 如 ，System.Timers.Timer 类 有 一 个 事件 Elapsed， 它 的 类 型 是 
ELapsedEventHandLer。 对 此 旧 类 事件 ， 可 以 用 下 面 的 方法 封装 进 FromEventPattern: 














var timer = new System.Timers.Timer(intervaL: 1000) { Enabled = true }; 

var ticks = Observable.FromEventPattern<ElapsedEventHandler, ElapsedEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => timer.Elapsed += handler, 





handler => timer.Elapsed -= handler); 
ticks.Subscribe(data => Trace.WriteLine("OnNext: 


+ data.EventArgs.SignalTinme)); 


注意 ，data.EventArgs 仍然 是 强 类 型 的 。 现 在 FromEventPattern 的 类 型 参数 是 对 应 的 事件 
处 理 程序 和 EventArgs 的 派生 类 。FromEventPattern 的 第 一 个 Lambda 参数 是 一 个 转换 器 
它 将 EventHandler<ElapsedEventArgs> 转换 成 ElapsedEventHandler。 除 了 传递 事件 ， 这 个 


转换 器 不 应 该 做 其 他 处 理 。 
上 面 代 码 的 语法 明显 有 些 别扭 。 另 一 个 方法 是 使 用 反射 机 制 : 


























var timer = new System.Timers.Timer(intervaL: 1000) { Enabled = true }; 
var ticks = Observable.FromEventPattern(timer, "Elapsed"); 
ticks.Subscribe(data => Trace.WriteLine("OnNext: " 

+ ((ElapsedEventArgs)data.EventArgs).SignalTime)); 


采用 这 种 方法 后 ， 调 用 FromEventPattern 就 简单 多 了 。 但 是 这 种 方法 也 有 缺点 : 出 现 了 
一 个 怪异 的 字符 串 ("Elapsed")， 并 且 消 息 的 使 用 者 不 是 强 类 型 了 。 就 是 说 ， 这 时 data. 
EventArgs 是 object 类 型 ， 需 要 人 为 地 转换 成 ElapsedEventArgs。 


讨论 

事件 是 Rx 流 数 据 的 主要 来 源 。 本 节 介 绍 如 何 封装 遵 循 标准 模式 的 事件 (标准 事件 模式 : 
第 一 个 参数 是 事件 发 送 者 ， 第 二 个 参数 是 事件 的 类 型 参数 )。 对 于 不 标准 的 事件 类 型 ， 可 
以 用 重 载 Observable.FromEvent 的 办 法 ， 把 事件 封装 进 0bservable 对 象 。 

















把 事件 封装 进 Observable 对 象 后 ， 每 次 引发 该 事件 都 会 调用 OnNext。 在 处 理 
AsyncCompletedEventArgs 时 会 发 生 令 人 奇怪 的 现象 ， 所 有 的 异常 信息 都 是 通过 数据 
形式 传递 的 (onNext)， 而 不 是 通过 错误 传递 (OnError)。 看 一 个 封装 WebcClient. 
DowntLoadStringCompLeted 的 例子 : 


var client = new WebClient(); 

var downloadedStrings = Observable.FromEventPpattern(client, 
"DownloadStringCompleted"); 

downloadedStrings.Subscribe( 


data => 
{ 
var eventArgs = (DownloadStringCompletedEventArgs)data.EventArgs; 
if (eventArgs.Error != null) 
Trace.WriteLine("OnNext: (Error) " + eventArgs.Error); 
else 


Trace.WriteLine("OnNext: + eventArgs.Result); 
}; 

ex => Trace.WriteLine("OnError: + ex.ToString()), 

() => Trace.WriteLine("OnCompleted")); 


client.DownloadStringAsync(new Uri("http://invalid.example.com/")); 


WebClient.DownloadstringAsync 出 错 并 结束 时 ，31| 发 带 有 异常 AsyncCompletedEventArgs.Error 
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的 事件 。 可 惜 Rx 会 把 这 作为 一 个 数据 事件 ， 因 此 这 个 程序 的 结果 是 显示 “OnNext:(Error)”， 
而 不 是 “OnError:”。 








有 些 事件 的 订阅 和 退 订 必须 在 特定 的 上 下 文中 进行 。 例 如 ， 很 多 UI 控件 的 事件 必须 在 UI 
线程 中 订阅 。Rx 提供 了 一 个 操作 符 subscribe0n， 可 以 控制 订阅 和 退 订 的 上 下 文 。 大 多 数 
情况 下 没 必 要 使 用 这 个 操作 符 ， 因 为 基于 UI 的 事件 订阅 通常 就 是 在 UI 线程 中 进行 的 。 

















参阅 
5.2 节 介 绍 如 何 修改 引发 事件 的 上 下 文 。 
5.4 市 介绍 如 何 对 事件 限 流 ， 以 免 订 阅 者 因 事 件 太 多 而 崩溃 。 


5.2 发 通知 给 上 下 文 


问题 


Rx 尽量 做 到 了 线程 不 可 知 (thread agnostic)。 因 此 它 会 在 任意 一 个 活动 线程 中 发 出 通知 
(例如 OnNext ) 。 




















但 是 我 们 通常 希望 通知 只 发 给 特定 的 上 下 文 。 例 如 UI 元 素 只 能 被 它 所 属 的 UI 线程 控制 ， 
因此 ， 如 果 要 根据 Rx 的 通知 来 修改 UI， 就 应 该 把 通知 “转移 ”到 UI 线程 。 


解决 方案 


Rx 提供 了 observeon 操作 符 ， 用 来 把 通知 转移 到 其 他 线程 调度 器 。 























看 下 面 的 例子 ， 使 用 Interval， 每 秒 钟 产生 一 个 onNext 通知 : 











private void Button_CLick(object sender, RoutedEventArgs e) 


攻 
Trace.WriteLine("UI thread is " + Environment.CurrentManagedThreadId); 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.Subscribe(x => Trace.NriteLine("IntervaL " + X + " on thread "+ 
Environment.CurrentManagedThreadId)); 
} 





用 我 的 电脑 测试 ， 显 示 结 果 为 : 


UI thread is 9 

Interval 0 on thread 10 
Interval 1 on thread 10 
Interval 2 on thread 11 
Interval 3 on thread 11 
Interval 4 on thread 10 





54 | 第 5 章 


IntervaL 5 on thread 11 
IntervaL 6 on thread 11 


因为 Interval 基于 一 个 定时 器 《没有 指定 的 线程 )， 通 知 会 在 线程 池 线程 中 引发 ， 而 不 是 
在 UI 线程 中 。 要 更 新 UI 元 素 ， 可 以 通过 0bserveon 输送 通知 ， 并 传递 一 个 代表 UI 线程 








的 同步 上 下 文 : 
private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
var uiContext = SynchronizationContext.Current; 
Trace.NriteLine("UI thread is " + Environment.CurrentManagedThreadId); 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.ObserveOn(uiContext) 
.Subscribe(x => Trace.NriteLine("IntervaL " + X + " on thread "+ 
Environment.CurrentManagedThreadId)); 
} 


observeon 的 另 一 个 常用 功能 是 可 以 在 必要 时 离开 UI 线程。 假设 有 这 样 的 情况 : 鼠标 一 移 
动 ， 就 意味 着 需要 进行 一 些 CPU 密集 型 的 计算 。 默 认 情 况 下 ， 所 有 的 鼠标 移动 事件 都 发 
生 在 UI 线程 ， 因 此 可 以 使 用 0bserveon 把 通知 移动 到 一 个 线程 池 线程 ， 在 那里 进行 计算 ， 
然后 再 把 表示 结果 的 通知 返回 给 UI 线程 : 











private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
var uiContext = SynchronizationContext.Current; 
邮 Trace.WriteLine("UI thread is " + Environment.CurrentManagedThreadId); 
Observable.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
电 handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Select(evt => evt.EventArgs.GetPosition(this)) 
.ObserveOn(Scheduler .Default) 
.Select(position => 


{ 
// 复杂 的 计算 过 程 。 
Thread.Sleep(100); 
var result = position.X + position.Y; 
Trace.WriteLine("Calculated result " + result + 
Environment.CurrentManagedThreadId); 
return result; 


on thread " + 


}) 

.ObserveOn(uiContext) 

.Subscribe(x => Trace.WriteLine("Result ”+ X + 
Environment.CurrentManagedThread1Id)); 


on thread " + 


} 


运行 这 段 代 码 的 话 ， 就 会 发 现 计算 过 程 是 在 线程 池 线 程 中 进行 的 ， 计 算 结 果 在 UI 线程 中 
显示 。 男 外 ， 还 会 发 现 计算 和 结果 会 滞后 于 输入 ， 形 成 等 待 的 队列 ， 这 种 现象 出 现 的 原因 
在 于 ， 比 起 100 秒 1 次 的 计算 ,鼠标 移动 的 更 新 频率 更 高 。Rx 中 有 几 种 技术 可 以 处 理 这 
种 情况 ， 其 中 一 个 常用 方法 是 对 输入 流速 进行 限制 ， 具 体会 在 5.4 市 介绍 。 





六 
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讨论 

实际 上 ，0bserveOn 是 把 通知 转移 到 一 个 Rx 调度 器 上 了 。 本 节 介 绍 了 默认 调度 器 ( 即 线程 
池 ) 和 一 种 创建 UI 调度 器 的 方法 。0bserveon 最 常用 的 功能 是 移 到 或 移出 UI 线程， 但 调 
度 器 也 能 用 于 别 的 场合 。6.6 节 介 绍 高 级 测试 时 ， 将 再 次 关注 调度 器 。 








参阅 

5.1 市 介绍 如 何 利用 事件 创建 序列 。 
5.4 市 介绍 如 何 限制 事件 流 的 流速 。 
6.6 节 介 绍 测试 Rx 代码 的 特殊 流程 。 


5.3 用 窗口 和 缓冲 对 事件 分 组 
问题 


有 一 系列 事件 ， 需 要 在 它们 到 达 时 进行 分 组 。 举 个 例子 ， 需 要 对 一 些 成 对 的 输入 作出 响 
应 。 第 二 个 例子 ， 需 要 在 2 秒 钟 的 窗口 期 内 ， 对 所 有 和 输入 进行 响应 。 


解决 方案 

Rx 提供 了 两 个 对 到 达 的 序列 进行 分 组 的 操作 : Buffer 和 Window。Buffer 会 留 住 到 达 的 
事件 ， 直 到 收 完 一 组 事件 ， 然 后 会 把 这 一 组 事件 以 一 个 集合 的 形式 一 次 性 地 转送 过 去 。 
Window 会 在 逻辑 上 对 到 达 的 事件 进行 分 组 ， 但 会 在 每 个 事件 到 达 时 立即 传递 过 去 。Buffer 
的 返回 类 型 是 I0bservable<IList<T>> (由 若干 个 集合 组 成 的 事件 流 ) ; Window 的 返回 类 型 
是 IObservable<I0bservable<T>> (由 若干 个 事件 流 组 成 的 事件 流 )。 























下 面 的 例子 使 用 Interval， 每 秒 创建 1 个 onNext 通知 ， 然 后 每 2 个 通知 做 一 次 缓冲 : 





private void Button Click(object sender, RoutedEventArgs e) 


{ 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.Buffer(2) 
.Subscribe(x => Trace.WriteLine( 
DateTime.Now.Second + ": Got " + x[0] + " and " + x[1])); 
} 





用 我 的 电脑 测试 ， 每 2 秒 产生 2 个 输出 : 


13: Got 0 and 1 
15: Got 2 and 3 
17: Got 4 and 5 
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19: Got 6 and 7 
21: Got 8 and 9 





下 面 的 例子 有 些 类 似 ， 使 用 Window 创建 一 些 事件 组 ， 每 组 包含 2 个 事件 : 


private void Button Click(object sender, RoutedEventArgs e) 
{ 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.Window(2) 
.Subscribe(group => 


{ 


Trace.WriteLine(DateTime.Now.Second + ": Starting new group"); 
group.Subscribe( 
x => Trace.NriteLine(DateTime.Now.Second + 


() => Trace.NriteLine(DateTime.Now.Second + 


: Saw " + X)， 
": Ending group")); 


3 
} 


用 我 的 电脑 测试 ， 输 出 的 结果 就 是 这 样 : 


17: Starting new group 
18: Saw 0 

19: Saw 1 

19: Ending group 

19: Starting new group 
20: Saw 2 

21: Saw 3 

21: Ending group 

21: Starting new group 
22: Saw 4 

23: Saw 5 

23: Ending group 

23: Starting new group 





wl 


这 儿 个 例子 说 明了 Buffer 和 Window 的 区 别 。Buffer 等 待 组 内 的 所 有 事件 ， 然 后 把 所 有 
件 作 为 一 个 集合 发 布 。Window 用 同样 的 方法 进行 分 组 ， 但 它 是 在 每 个 事件 到 达 时 就 发 布 。 


Buffer 和 Mndow 都 可 以 使 用 时 间 段 作为 参数 。 在 下 面 的 例子 中 ， 所 有 的 鼠标 移动 事件 被 
收集 进 窗 口 ， 每 秒 一 个 窗口 ， 














private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
Observable.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Buffer(TimeSpan.FromSeconds(1)) 
.Subscribe(x => Trace.WriteLine( 
DateTime.Now.Second + ": Saw 


+ X.Count + " items.")); 


} 
输出 的 结果 依赖 于 怎么 移动 鼠标 ， 类 似 于 这 样 : 





二 
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49: Saw 93 items . 
50: Saw 98 items . 
51: Saw 39 items . 
52: Saw 0 items . 
53: Saw 4 items . 
54: Saw 0 items . 
55: Saw 58 items . 


讨论 
Buffer 和 Window 可 用 来 抑制 输入 信息 ， 并 把 输入 塑造 成 我 们 想 要 的 样子 。 另 一 个 实用 技 
术 是 限 流 (throttling)， 将 在 5.4 节 介 绍 

Buffer 和 Windows 都 有 其 他 重 载 ， 可 用 在 更 高 级 的 场合 。 参 数 为 skip 和 timeshift 的 重 载 
能 创建 互相 重合 的 组 ， 还 可 跳 过 组 之 间 的 元 素 。 还 有 一 些 重 载 可 使 用 委托 ， 可 对 组 的 边界 
进行 动态 定义 。 








参阅 
5.1 市 介绍 如 何 利 用 事件 创建 序列 。 
5.4 市 介绍 对 事件 流 进行 限 流 。 


5.4 用 限 流 和 抽样 抑制 事件 流 


问题 
有 时 事件 来 得 太 快 ， 这 是 编写 响应 式 代码 时 经 常 磁 到 的 问题 。 一 个 速度 太 快 的 事件 流 可 导 
致 程序 的 处 理 过 程 月 并。 


解决 方案 
Rx 专门 提供 了 几 个 操作 符 ， 用 来 对 付 大 量 涌现 的 事件 数据 。Throttle 和 Sample 这 两 个 操 
作 符 提供 了 两 种 不 同方 法 来 抑制 快速 涌 来 的 输入 事件 。 


Throttle 建立 了 一 个 超时 窗口 ， 超 时 期 限 可 以 设置 。 当 一 个 事件 到 达 时 ， 它 就 重新 开始 计 
时 。 当 超时 期 限 到 达 时 ， 它 就 把 窗口 内 到 达 的 最 后 一 个 事件 发 布 出 去 。 


下 面 的 例子 也 是 监视 鼠标 移动 ， 但 使 用 了 Throttte， 在 鼠标 保持 静止 1 秒 后 才 报告 最 近 一 
条 移动 事件 。 
























































private void Button_CLick(object sender, RoutedEventArgs e) 


{ 


Observable.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
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handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Select(x => x.EventArgs.GetPosition(this)) 
.Throttle(TimeSpan.FromSeconds(1)) 
.Subscribe(x => Trace.NriteLine( 
DateTime.Now.Second + ": Saw " + (Xx.X + x.Y))); 


} 
输出 结果 依赖 于 鼠标 的 实际 动作 ， 我 的 测试 结果 是 这 样 ， 




















47: Saw 139 
49: Saw 137 
51: Saw 424 
56: Saw 226 


Throttle 常用 于 类 似 “ 文 本 框 自动 填充 ”这 样 的 场合 ， 用 户 在 文本 框 中 输入 文字 ， 当 他 停 
止 输入 时 ， 才 需要 进行 真正 的 检索 。 


为 抑制 快速 运动 的 事件 序列 ，sample 操作 符 使 用 了 另 一 种 方法 。Sample 建立 了 一 个 有 规律 
的 超时 时 间 段 ， 每 个 时 间 段 结束 时 ， 它 就 发 布 该 时 间 段 内 最 后 的 一 条 数据 。 如 果 这 个 时 间 
段 没 有 数据 ， 就 不 发 布 。 


下 面 的 例子 捕获 鼠标 移动 ， 每 隔 一 秒 采 样 一 次 。 与 Throttle 不 同 ， 使 用 sample 的 例子 中 ， 
不 需要 让 鼠标 静止 一 段 时间 ， 就 可 要 看 到 结果 。 

















private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
Observable.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Select(x => x.EventArgs.GetPosition(this)) 
.Sample(TimeSpan.FromSeconds(1)) 
.Subscribe(x => Trace.WriteLine( 
DateTime.Now.Second + ": Saw " + (Xx.X + x.Y))); 


} 
我 先 让 鼠标 静止 几 秒 钟 ， 然 后 连续 移动 ， 得 到 了 下 面 的 输出 结果 : 




















12: Saw 311 
17: Saw 254 
18: Saw 269 
19: Saw 342 
20: Saw 224 
21: Saw 277 


讨论 
对 于 快速 涌 来 的 输入 ， 限 流 和 抽样 是 很 重要 的 两 种 工具 。 别 忘 了 还 有 一 个 过 滤 输 入 的 简单 
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方法 ， 就 是 采用 标准 LINQ 的 Where 操作 符 。 可 以 这 样 说 ，Throttle 和 Samplte 操作 符 与 
Where 基本 差不多 ， 唯 一 的 区 别 是 Throttle、Sample 根据 时 间 段 过 滤 ， 而 Where 根据 事件 
的 数据 过 症 。 在 抑制 快速 涌 来 的 输入 流 时 ， 这 三 种 操作 符 提 供 了 三 种 不 同 的 方法 。 








参阅 
5.1 节 介 绍 如 何 创 建 事件 序列 。 
5.2 节 介 绍 如 何 修改 引发 


5.5 超时 


问题 
我 们 希望 事件 能 在 预定 的 时 间 内 到 达 ， 即 使 事件 不 到 达 ， 也 要 确保 程序 能 及 时 进行 响应 。 
通常 此 类 事件 是 单一 的 异步 操作 (例如 ， 等 待 Web 服务 请 求 的 响应 )。 


解决 方案 
Timeout 操作 符 在 输入 流 上 建立 一 个 可 调 市 的 超时 窗口 。 一 旦 新 的 事件 到 达 ， 就 重 置 超 
时 窗口 。 如 果 超 过 期 限 后 事件 仍 没 到 达 ，Timeout 操作 符 就 结束 流 ， 并 产生 一 个 包含 


TimeoutException 的 OnError 通知 。 








出 上 


了 件 的 上 下 文 。 




















下 面 的 代码 向 一 个 域名 发 出 Web 请求， 并 使 用 1 秒 作为 超时 值 : 


private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
var client = new HttpClient(); 
client.GetStringAsync("http://www.example.com/").ToObservable() 
.Timeout(TimeSpan.FromSeconds(1)) 
.Subscribe( 
x => Trace.NriteLine(DateTime.Now.Second + ": Saw " + x.Length), 
ex => Trace.WriteLine(ex)); 


} 


Timeout 非常 适用 于 异步 操作 ， 例 如 Web 请 求 ， 但 它 也 能 用 于 任何 事件 流 。 下 面 的 例子 在 
监视 鼠标 移动 时 使 用 Timeout， 使 用 起 来 更 加 简单 : 


private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
Observable.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Select(x => x.EventArgs.GetPosition(this)) 
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.Timeout(TimeSpan.FromSeconds(1)) 

.Subscribe( 
x => Trace.NriteLine(DateTime.Now.Second + ": Saw "+ (Xx.X + x.Y)), 
ex => Trace.WriteLine(ex)); 


} 
我 移动 了 一 下 鼠标 ， 然 后 停止 1 秒 ， 得 到 如 下 结果 : 





16: Saw 180 
16: Saw 178 
16: Saw 177 
16: Saw 176 


System.TimeoutException: The operation has timed out. 


值得 注意 的 是 ， 一 旦 向 onError 发 送 TineoutException， 整 个 事件 流 就 结束 了 ， 不 会 继续 
传 来 鼠标 移动 事件 。 为 了 阻止 这 种 情况 出 现 ，Tineout 操作 符 具有 重 裁 方式 ， 在 超时 发 生 
时 用 另 一 个 流 来 替代 ， 而 不 是 抛 出 异常 并 结束 流 。 


下 面 的 例子 ， 在 超时 之 前 观察 鼠标 移动 ， 超 时 发 生 后 进行 切换 ， 观 察 鼠 标点 击 : 


private void Button_CLick(object sender, RoutedEventArgs e) 
{ 
var clicks = Observable.FromEventPattern 
<MouseButtonEventHandler, MouseButtonEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => MouseDown += handler, 
handler => MouseDown -= handler) 
.Select(x => x.EventArgs.GetPosition(this)); 


Observable.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Select(x => x.EventArgs.GetPosition(this)) 
.Timeout(TimeSpan.FromSeconds(1), clicks) 
.Subscribe( 
x => Trace.WriteLine( 
DateTime.Now.Second + 
ex => Trace.WriteLine(ex)); 


: Saw 


+ X.X+"," + X.Y), 


} 


我 先 移动 一 下 鼠标 ,停止 1 秒 ， 然 后 在 两 个 不 同 的 位 置 点 击 。 下 面 的 输出 表明 ， 超 时 发 生 
前 鼠标 移动 事件 在 进行 快速 移动 ， 超 时 后 变 成 两 个 鼠标 点 击 事件 : 








49: Saw 95,39 
49: Saw 94,39 
49: Saw 94,38 
49: Saw 94,37 
53: Saw 130,141 
55: Saw 469,4 
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讨论 

Timeout 操作 符 对 优秀 的 程序 来 说 是 十 分 必要 的 ， 因 为 我 们 总 是 希望 程序 能 及 时 响应 ， 即 
使 外 部 环境 不 理想 。 它 可 用 于 任何 事件 流 ， 尤 其 是 在 异步 操作 时 。 需 要 注意 ， 此 时 内 部 的 
操作 并 没有 真正 取消 ， 操 作 将 继续 执行 ， 直 到 成 功 或 失败 。 




















参阅 

5.1 节 介 绍 如 何 利用 事件 创建 序列 。 

7.6 节 介 绍 如 何 把 异步 代码 封装 成 Observable 对 象 事件 流 。 
9.6 节 介 绍 收 到 CanceLLationToken 时 如 何 从 序列 中 退 订 。 


9.3 节 介 绍 用 CancellationToken 来 实现 超时 功能 。 





第 6 章 


测试 技巧 





测试 是 保证 软件 质量 必 不 可 少 的 环节 。 近 年 来 ， 提 倡 单 元 测试 的 人 越 来 越 多 ， 到 处 都 能 听 
到 有 关 单 元 测试 的 讨论 。 有 人 提倡 测试 驱动 型 的 开发 模式 ， 以 保证 软件 测试 和 开发 同步 进 
行 、 同 时 完成 。 大 家 都 知道 单元 测试 在 保证 代码 质量 和 整个 开发 过 程 中 的 作用 ， 然 而 大 多 
数 开发 人 员 直 到 今天 都 没有 真正 编写 过 单元 测试 。 








我 建议 大 家 至 少 写 一 些 单元 测试 ， 首 先 从 自己 觉得 最 没 信心 的 代码 开始 。 根 据 我 个 人 的 经 
验 ， 单 元 测试 主要 有 两 大 好 处 。 





(D 更 好 地 理解 代码 。 你 是 否 遇 到 过 这 种 情况 : 你 了 解 程序 的 某 个 部 分 能 正常 运行 ， 却 对 
它 的 实现 原理 一 无 所 知 。 当 软件 出 现 了 令 你 不 可 思议 的 错误 时 ， 这 种 疑问 常常 占据 你 
的 内 心 深 处 。 要 理解 那些 特别 “ 难 ” 的 代码 的 内 部 机 理 ， 编 写 单元 测试 就 是 一 个 很 好 
的 办 法 。 编 写 描述 代码 行为 的 单元 测试 之 后 ， 就 不 会 觉得 这 部 分 代码 神秘 了 。 编 写 一 
批 单 元 测试 后 ， 最 终 就 能 搞 清 那些 代码 的 行为 ， 以 及 它们 和 其 他 代码 之 间 的 依赖 关系 。 
































(2) 修改 代码 时 更 有 把 握 。 述 早 会 有 那么 一 天 ， 你 会 因为 有 功能 需求 而 必须 修改 那些 “ 妨 
怖 ”的 代码 ， 你 将 无 法 继续 假装 它 不 存在 。( 我 了 解 那 种 感觉 。 我 经 历 过 ! ) 最 好 提前 
做 好 准备 : 在 此 类 需求 到 来 之 前 ， 为 那些 恐怖 的 代码 编写 单元 测试 。 提 前 准备 ， 以 免 
以 后 麻烦 。 如 果 你 的 单元 测试 是 完整 的 ， 你 就 相当 于 有 了 一 个 早期 预警 系统 ， 如 果 修 
改 后 的 代码 影响 到 已 有 功能 时 ， 它 就 会 立即 发 出 警告 。 





























不 管 是 你 自己 还 是 其 他 人 的 代码 ， 都 能 获得 上 述 好 处 。 我 地 肯定 单元 测试 还 能 带 来 其 他 好 
处 。 单 元 测试 能 减少 错误 出 现 的 频率 吗 ? 很 有 可 能 。 单 元 测试 能 减少 项 目的 整体 时 间 吗 ? 
有 可 能 。 但 是 我 在 上 面 列 出 的 几 条 好 处 是 肯定 会 有 的 。 我 每 次 编写 单元 测试 时 都 能 感受 到 。 
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因此 ， 我 强烈 推荐 单元 测试 。 


本 章 的 内 容 全 部 是 关于 测试 的 。 很 多 开发 人 员 (其 至 包括 经 常 编写 单元 测试 的 人 ) 都 逃避 
并 发 代码 的 单元 测试 ， 因 为 他 们 总 觉得 非常 难 。 然 而 本 章 的 内 容 将 会 告诉 大 家 ， 并 发 代码 
的 单元 测试 并 没有 想象 中 那么 难 。 现 在 的 语言 功能 和 开发 库 ， 例 如 async 和 Rx， 在 测试 的 
方便 性 方面 做 了 很 多 考虑 ， 并 且 确 实 能 体现 出 这 点 。 我 建议 大 家 使 用 本 章 的 方法 编写 单元 
测试 ， 尤 其 是 并 发 编程 的 新 手 (就 是 认为 新 并 发 代码 “很 难 ” 或 “可 怕 ” 的 人 )。 


6.1 async 方 法 的 单元 测试 

问题 

需要 对 async 方法 进行 单元 测试 。 

解决 方案 

现在 大 多 数 单元 测试 框架 都 支持 async Task 类 型 的 单元 测试 ， 包 括 MSTest、NUnit、 


XUnit。 从 Visual Studio 2012 开始 ，MSTest 才 支 持 async Task 类 型 的 单元 测试 ， 因 此 需要 
将 老 版 本 升级 到 最 新 版 本 。 


下 面 是 一 个 async 类 型 MSTest 单元 测试 的 例子 : 










































































[TestMethod] 
public async Task MyMethodAsync_ReturnsFalse() 
‘ 

var objectUnderTest = ...; 


bool result = await objectUnderTest.MyMethodAsync(); 
Assert.IsFalse(result); 


} 
单元 测试 框架 检测 到 方法 的 返回 类 型 是 Task， 会 自动 加 上 await 等 待 任务 完成 ， 然 后 将 测 
试 结果 标记 为 “成 功 ” 或 “失败 ”。 
如 果 单 元 测试 框架 不 支持 async Task 类 型 的 单元 测试 ， 就 需要 做 一 些 额 外 的 修改 才能 等 待 
异步 操作 。 其 中 一 种 做 法 是 使 用 Task.wait， 并 在 有 错误 时 拆 开 AggregateException 对 象 。 
我 的 建议 是 使 用 NuGet 包 Nito.AsyncEx 中 的 AsyncContext 类 ， 
































[TestMethod] 
public void MyMethodAsync_ReturnsFalse() 
{ 
AsyncContext.Run(async () => 
{ 
var objectUnderTest = ...; 
bool result = await objectUnderTest.MyMethodAsync(); 
Assert.IsFalse(result); 





}); 
} 


AsyncContext.Run 会 等 待 所 有 异步 方法 完成 。 


讨论 
模拟 (mocking) 异步 方法 间 的 依赖 关系 ， 虽 说 它 给 人 的 第 一 感觉 是 有 点 别扭 ， 但 至 
少 可 以 测试 某 些 方法 如 何 响应 同步 成 功 (用 Task.FromResult 模拟 )、 同 步 出 错 (用 
TaskCompletionSource<T> 模拟 ) 以 及 异步 成 功 (用 Task.Yield 模拟 ， 并 返回 一 个 值 )， 六 
且 它 在 做 这 些 测试 时 ， 是 一 个 很 好 的 办 法 。 


跟 同步 代码 相 比 ， 在 测试 异步 代码 时 会 出 现 更 多 的 死 锁 和 竞 态 条 件 。 我 发 现 ， 对 每 个 测试 
进行 超时 设置 很 有 用 。 在 Visual Studio 中 ， 可 以 在 解决 方案 中 加 一 个 测试 设置 文件 ， 用 来 
对 每 个 测试 设置 独立 的 超时 参数 。 这 个 参数 的 默认 值 是 很 大 的 ， 我 通常 将 每 一 个 测试 的 超 
时 参数 设 成 2 秒 。 


让 











AsyncContext 类 在 NuGet 包 的 Nito.AsyncEx 中 。 








6.2 市 介绍 对 预计 失败 的 异步 方法 进行 单元 测试 。 


6.2 预计 失败 的 async 方 法 的 单元 测试 





需要 编写 一 个 单元 测试 ， 用 来 检查 async Task 方法 的 一 个 特定 错误 。 


解决 方案 
对 于 桌面 程序 或 服务 器 程序 ，MSTest 就 可 以 用 常规 的 ExpectedExceptionAttribute 进行 错 
误 测 试 : 

// 不 推荐 用 这 种 方法 ， 原 因 在 后 面 。 

[TestMethod] 

[ExpectedException(typeof(DivideByZeroException))] 


public async Task Divide WhenDenominatorIsZero_ThrowsDivideByZero() 


{ 
await MyClass.DivideAsync(4, 0); 


} 
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但 是 这 种 方法 并 不 是 最 好 的 。 一 方面 ，Windows 应 用 商店 并 没有 ExpectedException 支持 
单元 测试 。 另 一 个 本 质 的 原因 是 ExpectedException 的 设计 非常 糟糕 。 单 元 测试 中 调用 的 
任何 方法 都 可 以 抛 出 这 个 异常 。 更 好 的 设计 是 检查 抛 出 异常 的 那 段 代 码 ， 而 不 是 检查 整个 
单元 测试 。 











微软 公司 已 经 在 向 这 个 方向 努力 了 ， 在 Windows 应 用 商店 单元 测试 中 去 掉 了 Expected 
Exception， 改 成 用 Assert.ThrowsException<TException>， 使 用 方法 如 下 : 





[TestMethod] 
public async Task Divide_ WhenDenominatorIsZero_ThrowsDivideByZero() 


{ 


await Assert.ThrowsException<DivideByZeroException>(async () => 


{ 
await MyClass.DivideAsync(4, 0); 





























}); 
} 

千 万 别 忘 了 对 ThrowsException 返回 的 Task 使 用 await。 这 样 才 可 以 传递 出 

所 有 监测 到 的 出 错 信息 。 如 果 忘 记 使 用 await 并 且 忽 视 了 编译 器 的 警告 ， 那 

么 不 管 被 测试 的 方法 是 否 真 的 正确 ， 单 元 测试 就 会 一 直 显 示 测 试 成 功 且 不 给 

任何 提示 。 
可 异 ， 微软 只 在 Windows 应 用 商店 单元 测试 项 目 中 加 入 了 ThrowsException， 到 目前 为 止 
其 他 几 种 单元 测试 框架 并 没有 与 ThrowsException 等 效 的 、 兼 容 async 的 方法 。 这 时 我 们 
可 以 自行 创建 这 样 的 方法 : 








/1// <summary> 

/1// 确保 一 个 异步 委托 抛 出 异常 。 

/// </summary> 

/// <typeparam name="TException"> 

/// 所 预计 异常 的 类 型 。 

/// </typeparam> 

/// <param name="action"> 被 测试 的 异步 委托 </param> 

/// <param name="allowDerivedTypes"> 

/// 是 否 接 受 派生 的 类 。 

/// </param> 

public static async Task ThrowsExceptionAsync<TException>(Func<Task> action, 
bool allowDerivedTypes = true) 





‘ 
try 
{ 
await action(); 
Assert.Fail("Delegate did not throw expected exception 
typeof(TException).Name + "."); 


村 


Catch (Exception ex) 


if (allowDerivedTypes && !(ex is TException)) 





Assert.Fail("Delegate threw exception of type " + ex.GetType().Name + 
", but " + typeof(TException).Name + 
"or a derived type Was expected."); 

if (!allowDerivedTypes && ex.GetType() != typeof(TException)) 

Assert.Fail("Delegate threw exception of type " + ex.GetType().Name + 

", but " + typeof(TException).Name + " was expected."); 
} 
} 


调用 这 个 方法 跟 Windows 应 用 商店 的 MSTest 方法 Assert.ThrowsException<TException> 
一 样 。 千 万 别 忘记 对 返回 值 使 用 await | 


讨论 
对 错误 处 理 进行 测试 ， 与 测试 正确 的 场景 一 样 重要 。 其 至 有 人 认为 前 者 更 重要 ， 因 为 正确 


场景 是 每 个 人 在 软件 发 布 前 就 试 过 的 。 如 果 软 件 的 运行 情况 很 怪异 ， 可 能 是 因为 出 现 了 以 
前 没 预 料 到 的 错误 情形 。 



































不 过 ， 我 建议 大 家 不 要 使 用 ExpectedException。 它 更 适用 于 测试 某 个 特定 点 抛 出 的 异常 ， 而 不 
是 整个 测试 过 程 中 随时 会 抛 出 的 异常 。 不 用 ExpectedExceptton 的 话 ， 就 可 改 用 ThrowsException 
(或 者 单元 测试 框架 中 类 似 的 方法 )， 或 者 使 用 它 的 另 一 种 实现 ThrowsExcepttonAsync。 


参阅 

6.1 节 介 绍 异 步 方法 单元 测试 的 基础 知识 。 

6.3 async void 方法 的 单元 测试 
问题 

需要 对 一 个 asnyc void 类 型 的 方法 做 单元 测试 。 

解决 方案 


停 。 





要 尽 最 大 可 能 避免 这 个 问题 ， 而 不 是 去 解决 它 。 只 要 有 可 能 把 async void 方法 改 成 async 
Task， 那 就 得 改 。 


如 果 一 个 方法 必须 采用 async void (例如 为 满足 某 个 接口 方法 的 特征 )， 那 可 考虑 编写 两 
个 方法 : 一 个 包含 所 有 逻辑 的 async Task 方法 和 一 个 async void 方法。 这 个 async void 
方法 只 是 做 一 个 简单 封装 ， 即 调用 async Task 方法 ， 并 用 awatt 等 竺 结果。 这 样 ，async 
void 方法 可 满足 格式 要 求 ， 而 async Task 方法 (包含 所 有 逻辑 ) 可 用 于 测试 。 
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如 果真 的 不 可 能 修改 这 个 方法 ， 并 且 确 实 必 须 对 一 个 async void 方法 做 单元 测试 ， 可 试 试 
这 个 方法 ， 使 用 Ntto.AsyncEx 类 库 的 AsyncContext 类 : 





// 不 推荐 用 这 种 方法 ， 原 因 见 前 面 。 
[TestMethod] 
public void MyMethodAsync_DoesNotThrow() 
{ 

AsyncContext.Run(() => 

{ 





var objectUnderTest = ...; 
objectUnderTest.MyMethodAsync(); 
]); 
} 


这 个 AsyncContext 类 会 等 待 所 有 异步 操作 完成 (包括 async void 方法 )， 再 将 异常 传递 出 去 。 

















AsyncContext 在 NuGet 包 Nito.AsyncEx 中 。 








讨论 
在 async 代码 中 ， 关 键 准则 之 一 就 是 避免 使 用 async void。 我 非常 建议 大 家 在 对 async 
void 方法 做 单元 测试 时 进行 代码 重 构 ， 而 不 是 使 用 AsyncContext。 





参阅 

6.1 节 介 绍 异步 方法 单元 测试 的 基础 知识 。 

6.4 数据 流 网 格 的 单元 测试 
问题 

程序 中 有 一 个 数据 流 网 格 ， 需 要 对 它 进行 正确 性 验证 。 


解决 方案 
数据 流 网 格 是 独立 的 ， 有 自己 的 生命 周期 ， 并 且 本 质 上 就 是 异步 的 。 自 然而 然 ， 它 的 测试 
方法 就 是 使 用 异步 的 单元 测试 。 下 面 的 单元 测试 验证 4.6 节 中 的 自 定义 数据 流 块 








[TestMethod] 
public async Task MyCustomBlock_AddsOneToDataIltems() 





var myCustomBlock = CreateMyCustomBlock(); 


myCustomBlock.Post(3); 
myCustomBlock.Post(13); 
myCustomBlock.Complete(); 


Assert.AreEqual(4, myCustomBlock.Receive()); 
Assert.AreEqual(14, myCustomBlock.Receive()); 
await myCustomBlock.Completion; 


} 








Ba 

















可 惜 的 是 ， 对 错误 进行 单元 测试 就 没 那 么 简单 了 。 这 是 因为 在 数据 流 网 格 中 ， 异 常 信息 在 
块 之 间 传 递 时 会 被 一 层 一 层 地 封装 在 另 一 个 AggregateException 中 。 下 面 的 例子 使 用 了 一 























个 辅助 方法 ， 以 确保 一 个 异常 在 丢弃 数据 之 后 ， 再 在 自 定义 块 之 间 传 递 。 
[TestMethod] 
public async Task MyCustomBlock_Fault_DiscardsDataAndFaults() 
{ 


var myCustomBLock = CreateMyCustomBlock(); 


myCustomBlock.Post(3); 
myCustomBlock.Post(13); 
myCustomBlock.Fault(new InvalidOperationException()); 


try 
‘ 
await myCustomBlock.Completion; 
} 
catch (AggregateException ex) 
‘ 
AssertExceptionIs<InvalidOperationException>( 
ex.Flatten().InnerException, false); 
} 


} 


public static void AssertExceptionIs<TException>(Exception ex， 
bool allowDerivedTypes = true) 


{ 
if (allowDerivedTypes && !(ex is TException)) 
Assert.Fail("Exception is of type " + ex.GetType().Name + ", but " 
+ typeof(TException).Name + " or a derived type was expected."); 
if (!allowDerivedTypes && ex.GetType() != typeof(TException)) 
Assert.Fail("Exception is of type " + ex.GetType().Name + ", but " 
+ typeof(TException).Name + " was expected."); 
} 
外 * 
讨论 


直接 对 数据 流 网 格 做 单元 测试 是 可 行 的， 但 有 些 别扭 。 如 果 网 格 是 一 个 大 组 件 的 组 成 部 
分 ， 只 对 这 个 大 组 件 做 单元 测试 ( 隐 式 的 测试 网 格 )， 那 样 会 比较 简单 。 但 如 果 开 发 可 重 
用 的 自 定义 块 或 网 格 ， 那 就 应 该 像 前 面 那样 做 单元 测试 。 
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参阅 
6.1 节 介 绍 异 步 方 法 单元 测试 的 基础 知识 。 


6.5 ”Rx Observable 对 象 的 单元 测试 


问题 
程序 中 用 到 了 IObservable<T>， 需 要 对 这 部 分 程序 做 单元 测试 。 


解决 方案 

响应 式 扩展 (Reactive Extension) 有 很 多 产生 序列 的 操作 符 (如 Return)， 还 有 操作 符 可 
把 响应 式 序列 转换 成 普通 集合 或 项 目 (如 SingleAsync)。 我 们 可 使 用 Return 等 操作 符 创建 
Observable 对 象 依赖 项 的 存根 (stub)， 用 singleAsync 等 操作 符 来 测试 输出 。 


看 下 面 的 代码 ， 它 把 一 个 HTTP 服务 作为 依赖 项 ， 并 且 在 调用 HTTP 时 使 用 了 一 个 超时 : 


public interface IHttpService 





























IObservabLe<string> GetString(string url); 


} 

public class MyTimeoutClass 
private readonly IHttpService _httpService; 
public MyTimeoutClass(IHttpService httpService) 


_httpService = httpService; 


} 
public IObservabLe<string> GetStringWithTimeout(string url) 
€ 
return _httpService.GetString(url) 
.Timeout(TimeSpan.FromSeconds(1)); 
} 


} 


我 们 要 测试 的 代码 是 MyTineoutCclass， 它 消耗 一 个 Observable 对 象 依 赖 项 ， 生 成 一 个 
Observable 对 象 作 为 输出 。 


Return 操作 符 创 建 一 个 只 有 一 个 元 素 的 冷 序 列 (cold sequence) ， 可 用 它 来 构建 简单 的 存 
根 (stub)。SingtLeAsync 操作 符 返 回 一 个 Task<T> 对 象 ， 该 对 象 在 下 一 个 事件 到 达 时 完成 。 
SingleAsync 可 用 来 做 简单 的 单元 测试 ， 如 下 所 示 : 








class SuccessHttpServiceStub : IHttpService 


{ 


public IObservabLe<string> GetString(string url) 





return Observable.Return("stuyb"); 


} 
} 
[TestMethod] 
public async Task MyTimeoutClass_SuccessfulGet_ReturnsResult() 
{ 
var stub = new SuccessHttpServiceStub(); 
var my = new MyTimeoutClass(stub); 
var result = await my.GetStringWithTimeout("http://www.example.com/") 
.SingleAsync(); 
Assert.AreEqual("stub", result); 
} 


存根 代码 中 另 一 个 重要 操作 符 是 Throw， 它 返回 一 个 以 错误 结束 的 0bservable 对 象 。 
这 样 我 们 也 可 对 有 错误 的 场景 做 单元 测试 。 下 面 的 例子 使 用 了 6.2 市 中 的 辅助 方法 


ThrowsExceptionAsync: 





private class FailureHttpServiceStub : IHttpService 


{ 
public IObservabLe<string> GetString(string url) 
{ 
return Observable.Throw<string>(new HttpRequestException()); 
} 
} 
[TestMethod] 
public async Task MyTimeoutClass_FailedGet PropagatesFailure() 
{ 
var stub = new FailureHttpServiceStub(); 
var my = new MyTimeoutClass(stub); 
await ThrowsExceptionAsync<HttpRequestException>(async () => 
{ 
await my.GetStringWithTimeout("http://www.example.com/") 
.SingleAsync(); 
]); 
} 
4 Mg 
讨论 


Return 和 Throw 操作 符 很 适合 创建 observable 对 象 的 存根 ， 而 要 在 async 单元 测试 中 测试 
observable 对 象 ， 比 较 容 易 的 方法 就 是 使 用 SingleAsync。 对 于 简单 的 observable 对 象 ， 这 
两 个 操作 符 结 合 起 来 使 用 效果 很 好 。 但 如 果 observable 对 象 与 时 间 有 关 ， 它 们 就 不 那么 
管用 了 。 例 如 要 测试 MyTimeoutClass 类 的 超时 能 单元 测试 就 必须 真正 地 等 竺 那么 长 
时 间 。 一 旦 增加 更 多 的 单元 测试 ， 这 种 方式 就 不 大 合适 了 。6.6 市 介绍 一 种 特殊 的 方法 ， 
Reactive Extensions 可 以 把 时 间 本 身 排除 在 外 。 
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参阅 


6.1 节 介绍 对 async 方法 做 单元 测试 ， 这 与 用 await SingleAsync 进行 单元 测试 非常 相似 。 








这 
6.6 节 介 绍 对 依赖 于 时 间 的 observable 序列 做 单元 测试 。 


6.6 用 虚拟 时 间 测 试 Rx Observable 对 象 


问题 

需要 写 一 个 不 依赖 于 时 间 的 单元 测试 ， 来 测试 一 个 依赖 于 时 间 的 observable 对 象 。 如 
observable 对 象 中 使 用 了 超时 、 窗 口 /缓冲 、 限 流 / 抽样 等 方法 ， 那 它 就 是 依赖 于 时 间 的 。 
我 们 要 对 它们 做 单元 测试 ， 但 要 求 运行 时 间 不 能 太 长 。 


解决 方案 
我 们 当然 可 以 让 延迟 函数 在 单元 测试 中 运行 。 但 是 这 样 做 会 产生 两 个 问题 ，1) 单元 测试 的 
大 | 


运行 时 间 会 很 长 ，2) 因为 所 有 的 单元 测试 是 同时 运行 的 ， 这 样 做 会 导致 莞 态 条 件 ， 无 法 预 
测 运行 时 机 。 

















Rx 库 在 设计 时 就 考虑 到 了 测试 问题 。 实 际 上 ，Rx 库 本 身 就 已 经 过 大 量 单元 测试 。 为 了 解 
决 上 面 的 问题 ，Rx 引入 了 调度 器 (scheduler) 这 一 概念 ， 每 个 与 时 间 有 关 的 Rx 操作 都 在 
实现 时 使 用 了 这 个 抽象 的 调度 器 。 


要 让 observable 对 象 便于 测试 ， 就 要 允许 调用 它 的 程序 指定 调度 器 。 例 如 可 以 使 用 6.5 市 
的 MyTimeoutCLass， 并 加 上 一 个 调度 器 : 





public interface IHttpService 


{ 


IObservable<string> GetString(string url); 


} 


public class MyTimeoutClass 


{ 


private readonly IHttpService _httpService; 
public MyTimeoutClass(IHttpService httpService) 


_httpService = httpService; 


} 


public IObservabLe<string> GetStringWithTimeout(string url, 
IScheduler scheduler = null) 
{ 
return _httpService.GetString(url) 
.Timeout(TimeSpan.FromSeconds(1), scheduler ?? Scheduler .Default); 





} 
接 下 来 ， 修 改 HTTP 服务 存根 ， 加 入 调度 功能 ， 然 后 加 入 一 个 可 变 延 迟 


private class SuccessHttpServiceStub : IHttpService 


{ 
public IScheduler Scheduler { get; set; } 
public TimeSpan Delay { get; set; } 
public IObservabLe<string> GetString(string url) 
{ 
return Observable.Return("stub") 
.Delay(Delay, Scheduler); 
} 
} 


这 样 就 可 以 使 用 Rx 库 中 的 Testscheduler 了 。 可 以 用 Testscheduler 对 (虚拟) 时 间 进 行 
很 好 的 控制 。 





TestScheduler 在 Rx 中 一 个 单独 的 NuGet 包 中 ， 安装 NuGet 包 Rx-Testing。 





用 Testscheduler 可 以 对 时 间 进 行 完 整 的 控制 ， 但 通常 只 需要 写 好 代码 ， 然 后 调用 
TestSschedutLer.Start。 在 整个 测试 结束 前 ，Start 方法 可 以 用 虚拟 的 方式 推进 时 间 。 下 面 
是 一 个 成 功 测试 的 简单 例子 


[TestMethod] 
public void MyTimeoutClass_SuccessfulGetShortDelay_ReturnsResult() 


{ 
var scheduler = new TestScheduler(); 
var stub = new SuccessHttpServiceStub 


Scheduler = scheduler, 

Delay = TimeSpan.FromSeconds(0.5), 
}; 
var my = new MyTimeoutClass(stub); 
string result = null; 


my.GetStringWithTimeout("http://www.example.com/", scheduler) 
.Subscribe(r => { result = r; }); 


scheduler .Start(); 


Assert.AreEqual("stub", result); 
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这 段 代 码 模 拟 了 0.5 秒 的 网 络 延 时 。 需 要 强调 的 是 ， 这 个 单元 测试 实际 运行 时 间 并 没有 0.5 
秒 。 在 我 的 电脑 上 ， 做 这 个 测试 只 需 70 毫秒 左右 。 这 个 0.5 秒 的 延 时 只 不 过 是 虚拟 的 。 另 
一 个 值得 注意 的 差别 是 ， 这 个 单元 测试 不 是 异步 的 。 因 为 使 用 了 Testscheduler， 所 有 的 
测试 都 会 立即 完成 。 


好 了 ， 现 在 使 用 了 调度 器 ， 测 试 超时 的 情况 就 很 容易 了 : 











[TestMethod] 
public void MyTimeoutClass_SuccessfulGetLongDelay_ThrowsTimeoutException() 


{ 
var scheduler = new TestScheduler(); 
var stub = new SuccessHttpServiceStub 


Scheduler = scheduler, 

Delay = TimeSpan.FromSeconds(1.5), 
}; 
var my = new MyTimeoutClass(stub); 
Exception result = null; 


my.GetStringWithTimeout("http://www.example.com/", scheduler) 
.Subscribe(_ => Assert.Fail("Received valuye"), ex => { result = ex; }); 


scheduler .Start(); 


Assert.IsInstanceOfType(result, typeof(TimeoutException)); 


} 
再 强调 一 次 ， 运 行 这 个 单元 测试 不 需要 1 秒 (或 1.5 秒 )， 它 会 使 用 虚拟 时 间 立 即 完成 。 





讨论 
前 面 我 们 介绍 了 Reactive Extensions 的 调度 器 和 虚拟 时 间 的 入 门 知识 。Rx 编程 和 单元 测试 
最 好 能 同时 进行 。 请 放心 ， 即 使 代码 越 来 越 复杂 ，Rx 的 测试 功能 也 足以 应 对 了 。 


TestScheduler 还 有 AdvanceTo 和 AdvanceBy 方法 ， 可 用 来 逐步 地 推进 虚拟 时 间 。 这 些 方法 
dr 但 是 应 该 尽量 让 每 个 单元 测试 只 测试 一 项 内 容 。 例 如 在 测试 一 个 超 
时 功能 时 ， 可 只 写 一 个 单元 测试 ， 先 让 Testscheduler 前 进 一 段 时 间 ， 验 证 这 个 超时 不 会 
提前 发 生 。 ai Testscheduler 前 进 预 定 的 超时 时 间 ， 验 证 这 个 超时 确实 会 发 生 。 不 过 
我 建议 大 家 尽 可 能 使 用 独立 的 单元 测试 ， 例 如 一 个 单元 测试 验证 超时 不 会 提前 发 生 ， 另 一 
个 单元 测试 验证 超时 确实 会 在 后 面 发 生 。 























参阅 
6.5 节 介 绍 对 observable 对 象 序 列 做 单元 测试 的 基础 知识 。 








异步 、 并 行 、 响 应 式 一 一 每 种 技术 都 有 自己 的 用 武之 地 ， 但 是 结合 起 来 使 用 会 怎样 呢 ? 


本 章 我 们 来 看 一 下 各 种 互 操作 的 场景 ， 学 习 如 何 把 这 些 不 同 的 技术 结合 起 来 。 我 们 将 了 解 
到 这 几 种 技术 是 互 为 补充 而 不 是 互相 排斥 的 。 当 它们 结合 在 一 起 时 ， 在 边界 上 几乎 没有 什 
么 冲突 。 


7.1 用 async 代 码 封 装 Async 方 法 与 CompLeted 事 件 


问题 
有 一 种 老式 的 异步 编程 模式 ， 用 的 是 0perationAsync 方法 和 0perationCompleted 事件 。 我 
们 希望 实现 类 似 的 操作 ， 并 且 用 await 来 等 待 返回 的 结果 。 











使 用 0perationAsync 和 0perationCompleted 的 模式 称 为 基于 事件 的 异步 模式 
(EAP)。 我 们 要 把 它们 封装 成 返回 Task 对 象 的 方法 ， 并 且 让 它 符合 基于 任务 
的 异步 模式 〈TAP)。 














解决 方案 
可 以 使 用 TaskCompletionSource<TResult> 类 创建 异步 操作 的 容器 。 这 个 类 控制 一 个 
Task<TResult> 对 象 ， 并 且 可 以 在 适当 的 时 机 完成 该 任务 。 


/5 


下 面 的 例子 定义 了 一 个 WebClient 下 载 文本 的 扩展 方法 。 WebClient 类 定 


StringAsync 和 DownloadstringCompleted， 利 用 这 些 方法 ， 
StringTaskAsync 方法 : 





就 可 这 


检 


义 了 DownLoad 
定 义 Download 





public static Task<string> DownloadStringTaskAsync(this WebClient client, 


{ 


} 


Uri address) 


var tcs = new TaskCompletionSource<string>(); 





// 这 个 事件 处 理 程序 会 完成 Task 对 象 ， 并 自行 注销 。 
DownloadStringCompletedEventHandler handler = null; 
handler = (_, e) => 


4 








client.DownloadStringCompleted -= handler; 

if (e.Cancelled) 
tcs.TrySetCanceled(); 

else if (e.Error != nuLL) 
tcs.TrySetException(e.Error); 

else 
tcs.TrySetResult(e.Result); 

}; 


// 登记 事件 ， 然 后 开始 操作 。 
client.DownloadStringCompleted += handler; 
client.DownloadStringAsync(address); 





return tcs.Task; 


了 ， 那 么 实现 这 种 容器 就 会 更 简单 : 


因为 有 了 TryCompleteFromEventArgs 扩展 方法 ， 若 早已 经 在 使 用 NuGet 库 Nito.AsyncEx 


public static Task<string> DownloadStringTaskAsync(this WebClient client, 


{ 


Uri address) 


var tcs = new TaskCompletionSource<string>(); 





// 这 个 事件 处 理 程序 会 完成 Task 对 象 ， 并 自行 注销 。 
DownloadStringCompletedEventHandler handler = null; 
handler = (_, e) => 


{ 








client.DownloadStringCompleted -= handler; 
tcs.TryCompleteFromEventArgs(e, () => e.Result); 
}; 


// 登记 事件 ， 然 后 开始 操作 。 
client.DownloadStringCompleted += handler; 
client.DownloadStringAsync(address); 





return tcs.Task; 





讨论 

WebClient 已 经 定义 了 DownLoadstringTaskAsync， 并 且 还 可 以 使 用 更 加 适合 async 的 
HttpClient 类 ， 因 此 这 个 实例 并 没有 太 大 的 实用 价值 。 然 而 ， 对 于 那些 还 没有 升级 到 使 用 
Task 类 的 异步 代码 ， 可 以 用 这 种 技术 交互 。 





在 新 编写 代码 时 都 要 使 用 HttpCLient。 只 有 在 维护 以 前 遗留 的 代码 时 才 用 
WebClient, 























下 载 文 本 的 TAP 方法 一 般 应 该 命名 为 OoperationAsync (例如 DownloadStringAsync), 但 
本 例 的 情况 无 法 接受 这 样 的 命名 习惯 ， 因 为 EAP 中 已 经 用 了 这 个 名 称 。 这 时 ， 习 惯 上 把 
TAP 方法 命名 为 OperationTaskAsync (例如 DwonloadStringTaskAsync)。 


在 封装 EAP 方法 时 ,“ 启 动 ”方法 有 可 能 抛 出 异常 。 前 面 的 例子 中 可 能 抛 出 异常 的 方法 就 
是 DowntoadStringAsync。 这 时 开发 者 需要 做 出 选择 : 是 让 异常 继续 传递 ， 还 是 捕获 异常 并 
调用 TrySetException。 在 那个 位 置 抛 出 异常 通常 是 因为 使 用 不 当 ， 因 此 选择 哪 一 种 方式 都 
可 以 ， 区 别 不 大 。 





参阅 


7.2 节 对 APM 方法 (BeginOperation 和 Endoperation) 进行 TAP 封装 。 














7.3 市 对 各 种 类 型 的 通知 进行 TAP 封装 。 


7.2 用 async 代 码 封装 Begin/End 方 法 
问题 


有 一 种 老式 的 异步 编程 模式 ， 它 使 用 一 对 名 为 Begin0peration 和 Endoperation 的 方法 来 和 
表示 这 个 异步 操作 的 IAsyncResult 接口 。 我 们 希望 能 用 await 来 调用 这 种 模式 的 操作 。 


使 用 Beginoperation 和 End0peration 的 模式 称 为 异步 编程 模型 (APM)。 我 
们 要 把 它们 封装 成 返回 Task 对 象 的 方法 ， 符 合 基于 任务 的 异步 模式 (TAP)。 














解决 方案 


封装 APM 最 好 的 办 法 是 使 用 TaskFactory 类 型 的 一 个 FromAsync 方法 。FromAsync 在 内 部 
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使 用 TaskCompLetionSource<ResuLt>， 但 在 封装 APM 时 ，FromAsync 用 起 来 更 方便 。 





下 面 的 例子 定义 了 一 个 WebRequest 的 扩展 方法 ， 发 送 一 个 HITP 请 求 并 获取 响应 。Web Request 
类 定义 了 BeginGetResponse 和 EndGetResponse。 我 们 可 以 这 样 定义 GetResponse Async 方法 : 

















public static Task<NebResponse> GetResponseAsync(this WebRequest client) 


长 
return Task<WebResponse>.Factory.FromAsync(client.BeginGetResponse, 
client.EndGetResponse, null); 


} 
讨论 
FromAsync 的 重 载 个 数 多 得 一 塌 糊 涂 ! 


通常 来 讲 ， 最 好 用 例子 中 的 方式 调用 FromAsync。 首 先 传人 Beginoperation 方法 (不 调 
用 ) 和 Endoperation8 方法 (不 调用 )。 接 着 传 入 Begin0peration 所 需 的 全 部 参数 (后面 的 
AsyncCallback 和 object 参数 除外 )。 最 后 传 入 null。 





这 里 要 特别 指出 的 是 ， 不 要 在 调用 FromAsync 之 前 调用 Begin0peration。 调 用 FromAsync， 
并 让 用 Beginoperation 方法 返回 的 IAsync0peration 作为 参数 ， 这 样 也 是 可 以 的 ， 但 是 
FromAsync 会 采用 效率 较 低 的 实现 方式 。 








也 许 你 会 感到 奇怪 ， 怎 么 推荐 的 这 个 模式 总 是 在 最 后 传人 nuLL。FromAsync 是 在 .NET 4.0 
版 本 中 和 Task 类 一 起 被 引入 的 ， 当 时 还 没有 关键 字 async。 当 时 在 异步 回调 函数 中 普遍 使 
用 state 对 象 ，Task 类 通过 AsyncState 成 员 来 支持 这 种 调用 方式 。 新 的 async 模式 就 再 也 
不 需要 state 对 象 了 。 
参阅 
7.3 而 介绍 为 任何 类 型 的 通知 编写 TAP 封装 器 。 
% SS 士 [一 
7.3 用 async 代 码 封装 所 有 异步 操作 
问题 
有 一 个 不 常见 或 不 标准 的 异步 操作 或 事件 ， 我 们 希望 能 用 await 来 调用 。 
解决 方案 
任何 情况 下 都 可 以 用 TaskCompletionSource<T> 类 来 构造 Task<T> 对 象 。 使 用 Task 


CompletionSource<T> 时 ，Task 对 象 的 完成 可 以 有 三 种 不 同 的 方式 : 成 功 得 到 结果 、 出 错 、 
被 取消 。 























在 async 出 现 前 ， 微 软 推荐 另外 两 种 异步 编程 模式 : APM ( 见 7.2 节 ) 和 EAP ( 见 7.1 
节 )。 但 APM 和 EAP 都 相当 繁琐 ,也 经 常 难以 得 到 正确 结果 。 因 此 产生 了 一 种 非 官 方 的 
通行 做 法 ， 即 使 用 回调 函数 ， 就 像 下 面 的 方法 : 





public interface IMyAsyncHttpService 


{ 








void DownloadString(Uri address, Action<string, Exception> callback); 


} 


此 类 方法 遵循 这 样 的 通行 流程 : DwonloadString 启动 (异步 地 ) 下 载 ， 下 载 完 成 上 时， 包含 
返回 信息 或 异常 信息 的 callback 被 触发 。 通 常 catlback 是 在 后 台 线 程 中 被 触发 的 。 











这 个 非 标准 类 型 的 异步 编程 方法 ， 也 能 用 TaskCompletionSource<T> 进行 封装 ， 能 让 await 





进行 正常 调用 : 


public static Task<string> DownLoadStringAsync( 
this IMyAsyncHttpService httpService, Uri address) 


{ 
var tcs = new TaskCompletionSource<string>(); 
httpService.DownloadString(address, (result, exception) => 
‘ 
if (exception != null) 
tcs.TrySetException(exception); 
else 
tcs.TrySetResult(result); 
]); 
return tcs.Task; 
} 
外 全 
讨论 


这 种 模式 结合 TaskCompLetionSource<T>， 可 以 封装 任何 异步 方法 ， 不 管 它 有 多 么 不 标准 。 
首先 创建 TaskCompletionSource<T> 实例 。 接 着 准备 一 个 回调 国 数 ， 以 便 TaskCompletion 
Source<T> 能 顺利 完成 它 的 Task 对 象 。 然 后 开始 真正 的 异步 操作 。 最 后 返回 附属 于 


TaskCompletionSource<T> 的 Task<T>。 





关于 这 种 模式 有 一 点 十 分 重要 ， 就 是 必须 确保 TaskComptetionsource<T> 总 是 处 于 完成 状态 。 
尤其 要 仔细 地 检查 一 下 错误 处 理 过 程 ， 并 且 确 保 TaskCompletionSource<T> 会 正常 完成 。 在 最 


后 一 个 例子 中 ， 异 常 被 显 式 传递 进 回调 函数 ， 





因此 程序 中 不 需要 有 catch 块 。 但 是 一 些 非 标 


准 的 模式 会 要 求 在 回调 函数 中 捕获 异常 ， 并 把 异常 信息 放 在 TaskCompletion Source<T> 中 。 


参阅 


7.1 节 介 绍 对 EAP 模式 的 成 员 (0perationAsync、0perationCompleted) 进行 TAP 封装 。 





7.2 节 介 绍 对 APM 模式 的 成 员 (Begin0peration，EndOperation) 进行 TAP 封装 。 
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忆 土 十 斗士 AH 办 一 忆 
7.4 用 async 代 码 封 装 并 行 代码 
问题 
希望 用 await 调用 计算 密集 型 的 处 理 过程 。 采 用 这 种 做 法 后 ， 在 等 待 并 行 处 理 完成 时 能 避 
免 UI 线程 阻塞 。 
解决 方案 
paratlel 类 和 并 行 LINQ 利用 线程 池 做 并 行 处 理 。 它 们 也 会 把 调用 线程 作为 并 行 处 理 的 线程 
之 一 ， 因 此 从 UI 线程 调用 并 行 方法 时 ，UI 会 在 并 行 处 理 结束 前 一 直 保 持 停止 响应 状态 。 


要 让 UI 保持 响应 的 话 ， 就 可 将 并 行 处 理 过 程 封 装 进 Tast.Run， 并 使 用 await: 



































await Task.Run(() => Parallel.ForEach(...)); 
这 个 方法 的 关键 ， 是 并 行 代码 把 调用 线程 也 看 做 是 用 于 并 行 处 理 的 线程 池 的 一 部 分 。 并 行 
LINQ 和 Parallel 类 都 是 这 样 来 处 理 的 。 
讨论 
这 个 方法 很 简单 ， 却 经 常 被 忽视 。 通 过 使 用 Task.Run， 所 有 的 并 行 处 理 过 程 都 推 给 了 线程 
池 。Task.Run 返回 一 个 代表 并 行 任务 的 Task 对 象 ，UI 线程 可 以 (异步 地 ) 等 待 它 完成 。 


















































这 个 方法 只 能 用 于 UI 代码 。 在 服务 器 端 〈 例 如 ASP.NET) 很 少 用 并 行 处 理 。 如 果 一 定 要 
在 服务 器 端 使 用 并 行 处 理 过程 ， 那 也 应 该 直接 调用 它 ， 而 不 能 把 它 推 给 线程 池 。 











参阅 
第 3 章 介 绍 了 并 行 代码 的 基础 知识 。 
第 2 章 介 绍 了 异步 代码 的 基础 知识 。 


7.5 用 async 代 码 封 装 Rx Observable 对 象 




















问题 
希望 用 await 来 处 理 一 个 可 观 窦 流 。 
解决 方案 





首先 需要 确定 事件 流 中 的 哪 一 个 事件 是 需要 关注 的 。 通 党 有 几 种 情况 : 











。 事件 流 结束 前 的 最 后 一 个 事件 ; 
。 下 一 个 事件 ; 

。 所 有 事件 。 
要 捕获 事件 流 的 最 后 一 个 事件 ， 可 用 await 调用 LastAsync 方法 的 结果 ,或 者 直接 对 
Observable 对 和 象 进 行 await: 














IObservable<int> observable = ...; 
int LastELement = await observable.LastAsync(); 
// 或 者 int lastElement = await observable; 





在 await 调用 Observable 对 象 或 LastAsync 时 ,代码 (异步 地 ) 等 待 事件 流 完成 ， 然 后 返 
回 最 后 一 个 元 素 。 在 内 部 ，await 实际 是 在 订阅 事件 流 。 


使 用 FirstAsync 可 捕获 事件 流 中 的 下 一 个 事件 。 本 例 中 await 订阅 事件 流 ， 然 后 在 第 一 个 
事件 到 达 后 立即 结束 〈 并 退 订 ) : 

















IObservable<int> observable = ...; 
int nextELement = await observable.FirstAsync(); 


使 用 ToList 可 捕获 事件 流 中 的 所 有 事件 : 








IObservable<int> observable = ...; 
IList<int> allElements = await observable.ToList(); 


讨论 

Rx 库 提 供 了 await 处 理事 件 流 所 需 的 全 部 工具 。 唯 一 的 难点 是 我 们 必须 孝 虑 这 些 方 法 是 否 
会 一 直 等 待 ， 直 到 事件 流 结束 。 本 市 的 例子 中 ，LastAsync、ToList 和 直接 使 用 await 会 等 
待 事件 流 结 束 ，FirstAsync 只 会 等 待 下 一 个 事件 到 达 。 

如 果 这 些 例 子 不 能 满足 需求 ， 还 可 以 考虑 使 用 完整 的 LINQ 功能 和 新 版 Rx 控制 器 。 如 果 
只 要 异步 地 等 待 某 些 元 素 而 不 是 整个 事件 流 完成 ， 可 以 使 用 Task 和 Buffer 等 操作 符 。 


























某 些 和 await 一 起 使 用 的 操作 符 (如 FirstAsync 和 LastAsync) 并 不 会 真正 地 返回 Task<T> 
对 象 。 如 果 要 使 用 Task.WhenAll 或 Task.WhenAny， 就 需要 有 实际 的 Task<T> 对 象 。 可 在 
Observable 对 象 上 调用 ToTask， 以 得 到 这 个 Task<T> 对 象 ， 该 对 象 代表 着 事件 流 结束 时 的 
最 后 一 个 值 。 





参阅 
7.6 节 介 绍 在 可 观察 流 中 使 用 异步 代码 。 
7.7 节 介 绍 用 可 观察 流 作为 数据 流 块 的 输入 (该 数据 流 块 可 以 异步 运行 )。 
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5.3 市 对 可 观察 流 进行 窗口 和 缓冲 操作 。 


7.6 用 Rx Observable 对 和 象 封 装 async 代 码 


问题 

需要 把 一 个 异步 操作 与 一 个 observable 对 象 结合 。 

解决 方案 

任何 异步 操作 都 可 看 作 一 个 满足 以 下 条 件 之 一 的 可 观察 流 : 

。 生成 一 个 元 素 后 就 完成 ; 

。 发 生 错 误 ， 不 生成 任何 元 素 。 

Rx 库 中 有 一 个 将 Task<T> 转换 成 IObservabLe<T> 的 简单 方法 。 下 面 的 代码 启动 一 个 异步 的 
网 页 下 载 过 程 ， 并 把 它 作 为 一 个 observable 序列 : 





var client = new HttpClient(); 

IObservable<HttpResponseMessage> response = 
client.GetAsync("http://www.example.com/") 
.ToObservable(); 


使 用 ToObservable 前 必须 调用 async 方法 并 转换 成 Task 对 象 。 


另 一 个 办 法 是 调用 StartAsync。StartAsync 也 会 立即 调用 async 方法 ,但 它 支 持 取 消 功 能 : 
如 果 订 阅 已 被 处 理 ， 这 个 async 方法 就 会 被 取消 : 





var client = new HttpClient(); 
IObservable<HttpResponseMessage> response = Observable 
.StartAsync(token => client.GetAsync("http://www.example.com/", token)); 





ToObservable 和 StartAsync 都 会 立即 启动 异步 操作 ， 而 不 会 等 待 订 阅 。 如 果 要 让 observable 
对 象 在 接受 订阅 后 才 启 动 操 作 ， 可 使 用 FromAsync ( 跟 StartAsync 一 样 ， 它 也 支持 取消 
功能 ) : 





var client = new HttpClient(); 
IObservable<HttpResponseMessage> response = Observable 
.FromAsync(token => client.GetAsync("http://www.example.com/", token)); 
FromAsync 和 ToObservable、StartAsync 有 着 显著 的 区 别 。ToobservabtLe 和 StartAsync 都 
返回 一 个 observable 对 象 ， 表 示 一 个 已 经 启动 的 异步 操作 。FromAsync 在 每 次 被 订阅 时 都 会 
局 动 一 个 全 新 独立 的 异步 操作 。 


最 后 ， 如 果 要 在 源 事件 流 中 每 到 达 一 个 事件 就 启动 一 个 异步 操作 ， 就 可 使 用 SelectMany 的 
































特殊 重 载 。SeLectMany 也 支持 取消 功能 。 
下 面 的 例子 使 用 一 个 已 有 的 URL 事件 流 ， 在 每 个 URL 到 达 时 发 出 一 个 请 求 : 





IObservable<string> urls = ... 

var client = new HttpClient(); 

IObservable<HttpResponseMessage> responses = urls 
.SelectMany((url, token) => client.GetAsync(uyrl, token)); 


讨论 
响应 式 扩展 在 async 引进 之 前 就 存在 了 ,但 后 来 增加 了 上 述 (和 其 他 ) 操作 符 ， 以 便 与 
async 代码 互通 。 即 使 能 够 用 其 他 Rx 操作 符 实现 同样 的 功能 ， 我 还 是 建议 大 家 使 用 上 面 提 
到 的 操作 符 。 





参阅 
7.5 节 介 绍 在 异步 代码 中 使 用 可 观察 流 。 
7.7 节 介 绍 用 数据 流 块 (可 包含 异步 代码 ) 作为 可 观察 流 的 来 源 。 


7.7 Rx Observable 对 象 和 数据 流 网 格 
问题 


同一 个 项 目 中 ， 一 部 分 使 用 了 Rx Observable 对 象 ， 一 部 分 使 用 了 数据 流 网 格 ， 现 在 需要 
它们 能 互相 沟通 。 


Rx Observable 对 象 和 数据 流 网 格 有 各 自 的 用 途 ， 也 存在 一 些 概念 上 的 重 琶 。 本 节 说 明 它 们 
能 互相 配合 得 很 好 ， 因 此 可 以 在 项 目 中 的 不 同 部 分 选用 最 合适 的 工具 。 


解决 方案 
首先 ， 我 们 芳 虑 把 数据 流 块 用 作 可 观察 流 的 输入 。 下 面 的 代码 创建 一 个 缓冲 块 ( 它 不 处 理 
数据 ) ， 然 后 调用 As0bservable 来 创建 一 个 缓冲 块 到 Observable 对 象 的 接口 : 








var buffer = new BufferBlock<int>(); 
IObservable<int> integers = buffer.AsObservable(); 
integers.Subscribe(data => Trace.WriteLine(data), 
ex => Trace.WriteLine(ex), 
() => Trace.WriteLine("Done")); 


buffer .Post(13); 
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缓冲 数据 流 块 和 可 观察 流 都 会 正常 完成 或 者 出 错 ，As0bservable 方法 会 把 数据 流 块 的 完成 
信息 (或 出 错 信息 ) 转化 为 可 观察 流 的 完成 信息 。 如 果 数 据 流 块 出 错 并 抛 出 异常 ， 这 个 异 
常 信息 在 传递 给 可 观察 流 时 ， 会 被 封装 在 AggregateException 对 象 中 。 这 种 方式 与 互相 连 
接 的 数据 流 块 之 间 传 递 错误 的 方式 有 些 相 似 。 

















如 果 使 用 一 个 网 格 并 把 它 作 为 可 观 窦 流 的 目的 ， 情 况 只 会 稍微 复杂 一 点 。 下 面 的 代码 调用 
AsObserver 让 一 个 块 订阅 一 个 可 观察 流 : 





IObservabLe<DateTimeOffset> ticks = 
Observable.Interval(TimeSpan.FromSeconds(1)) 
.Timestamp() 

.Select(x => x.Timestamp) 
.Take(5); 


var display = new ActionBlock<DateTimeOffset>(x => Trace.WriteLine(x)); 
ticks.Subscribe(display.AsObserver()); 


try 


display.Completion.Wait(); 
Trace.WriteLine("Done."); 


catch (Exception ex) 


{ 


Trace.WriteLine(ex); 


} 








跟前 面 一 样 ， 可 观察 流 的 完成 信息 会 转化 为 块 的 完成 信息 ， 可 观察 流 的 错误 信息 会 转化 为 
块 的 错误 信息 。 


讨论 
数据 流 块 和 可 观察 流 的 很 多 基础 概念 是 一 样 的 。 它 们 都 能 传递 数据 ， 都 能 处 理 完成 信息 和 


错误 信息 。 它 们 是 为 不 同 的 场景 设计 的 。TPL 数据 流 针对 异步 和 并 行 混合 编程 ， 而 Rx 针 
对 响应 式 编程 。 但 概念 上 的 重合 部 分 具有 足够 的 兼容 性 ， 两 者 能 配合 得 很 好 、 很 自然 。 














参阅 
7.5 节 介 绍 在 异步 代码 中 使 用 可 观 罕 流 。 
7.6 节 介 绍 在 可 观察 流 中 使 用 异步 代码 。 








使 用 合适 的 集合 对 于 并 发 程序 来 说 是 必 不 可 少 的 。 这 里 我 们 不 讨论 标准 的 集合 ， 例 如 
List<T>， 因 为 这 些 大 家 早 就 很 熟悉 了 。 本 章 介 绍 一 些 专 门 用 于 并 发 或 异步 开发 的 新 集合 。 








不 可 变 集合 是 永远 不 会 改变 的 集合 。 这 种 集合 看 起 来 好 像 没 什么 用 处 ， 但 实际 上 它们 用 途 
很 广泛 ， 甚 至 能 用 在 单线 程 、 非 并 发 的 程序 中 。 只 读 操 作 (如 枚 举 ) 直接 访问 不 可 变 集 合 
实例 。 写 入 操作 (如 增加 一 个 项 目 ) 会 返回 一 个 新 的 不 可 变 集合 实例 ， 而 不 是 修改 原来 的 
实例 。 乍 一 听 上 去 ， 这 种 做 法 浪费 存储 空间 ， 但 不 可 变 集 合 之 间 通 常 共享 了 大 部 分 存储 空 
间 ， 因 此 其 实 浪费 并 不 大 。 并 且 不 可 变 集合 有 个 优势 ， 多 个 线程 访问 是 安全 的 。 因 为 是 无 
法 修改 的 ， 所 以 是 线程 安全 的 。 











不 可 变 集 合 在 NuGet 包 Microsoft.Bcl.Immutable 中 。 











在 编写 本 书 时 ， 不 可 变 集合 还 是 一 个 新 事物 。 但 所 有 新 开发 中 都 应 该 考虑 使 用 不 可 变 集合 ， 
除非 确实 需要 可 变 的 集合 。 如 果 你 对 不 可 变 集 合 还 不 熟悉 ， 哪 怕 你 并 不 需要 栈 或 队列 ， 也 
建议 你 从 8.1 市 开始 阅读 ， 因 为 那 一 市 介绍 了 所 有 不 可 变 集合 都 遵循 的 一 些 通 用 模式 .。 


如 果 要 用 很 多 已 有 的 元 素来 构建 不 可 变 集合 ， 可 使 用 一 些 高 效 的 特殊 方法 来 完成 。 在 这 几 
节 的 例子 中 ， 每 次 只 会 添加 一 个 元 素 。MSDN 文档 中 有 关于 如 何 快 速 构建 不 可 变 集合 的 描 
述 。 表 8-1 是 各 平台 对 不 可 变 集合 的 支持 情况 。 
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表 8-1: 各 平台 对 不 可 变 集合 的 支持 


于 台 ImmutableStack<T> 等 





.NET4.5 A 
.NET4.0 

Mono i0S/Droid 

Windows Store 

Windows Phone Apps 8.1 
Windows Phone SL 8.0 
Windows Phone SL 7.1 


x x < 人 < x 


Silverlight 5 


线程 安全 集合 是 可 同时 被 多 个 线程 修改 的 可 变 集合 。 线 程 安全 集合 混合 使 用 了 细 粒 度 锁定 
和 无 锁 技 术 ， 以 确保 线程 被 阻塞 的 时 间 最 短 (通常 情况 下 是 根本 不 阻塞 )。 对 很 多 线程 安 
全 集合 进行 枚 举 操 作 时 ， 内 部 创建 了 该 集合 的 一 个 快照 (snapshot) ， 并 对 这 个 快照 进行 枚 
举 操作 。 线 程 安全 集合 的 主要 优点 是 多 个 线程 可 以 安全 地 对 其 进行 访问 ， 而 代码 只 会 被 阻 
塞 很 短 的 时 间 ， 或 根本 不 阻塞 。 表 8-2 是 各 平台 对 线程 安全 集合 的 支持 情况 。 














表 8-2: 各 平台 对 线程 安全 集合 的 支持 


平 何 ConcurrentDictionary<Tkey TValue> 等 





.NET 4.5 

.NET 4.0 

Mono i0S/Droid 

Windows Store 

Windows Phone Apps 8.1 
Windows Phone SL 8.0 
Windows Phone SL 7.1 


xX 交 


Silverlight 5 


生产 者 / 消费 者 集合 是 一 种 可 变 集 合 ， 这 类 集合 的 设计 带 有 特殊 的 目的 : 支持 (可 能 有 多 
个 ) 生产 者 向 集合 推送 项 目 ， 同 时 支持 (可 能 有 多 个 ) 消费 者 从 集合 取 走 项 目 。 它 们 在 生 
产 者 代码 和 消费 者 代码 之 间架 设 了 桥梁 ， 并 且 可 通过 设置 来 限制 集合 中 的 项 目 数量 。 生 产 
者 /消费 者 集合 可 以 有 阻塞 或 异步 的 API。 例 如 ， 集 合 为 空 时 ， 一 个 阻塞 的 生产 者 / 消费 
者 集合 会 阻塞 正在 调用 的 消费 者 线程 ， 直 到 有 一 个 项 目 加 入 集合 它 才 停止 。 但 是 一 个 异步 
的 生产 者 /消费 者 集合 会 使 消费 者 线程 进行 异步 等 待 ， 直 到 加 入 另 一 个 项 目 。 表 8-3 是 各 
平台 对 生产 者 / 消费 者 集合 的 支持 情况 。 


表 8-3: 各 平台 对 生产 者 /消费 者 集合 的 支持 














平 奇 BlockingCollection<T> BufferBLock<T> AsyncProducerConsumerQueue<T> AsyncCollection<T> 
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( 续 ) 


BlockingCollection<T> BufferBLock<T> AsyncProducerConsumerQueue<T> AsyncCollection<T> 





Mono i0S/Droid 
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本 章 用 到 了 多 种 不 同 的 生产 者 / 消费 者 集合 ， 
者 /消费 者 集合 的 选择 。 


表 8-4: 生产 者 /消费 者 集合 


Vv 
Vv 
Vv 
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Vv 
Vv 
Vv 


Vv 
Vv 
Vv 


Vv 
Vv 
Vv 


AsyncProducerConsumerQueue<T> 和 AsyncCollection<T> 在 NuGet 包 Nito. 





ASsyncCExX 口 





ph。BufferBlock<T> 在 NuGet 包 Microsoft.TpL.DatafLow 中 。 


它们 各 有 不 同 的 优势 。 表 8-4 可 用 于 队 生产 








功 能 BlockingCollection<T> BufferBLock<T> AsyncProducerConsumerQueue<T> AsyncCoLLecton<T> 
队列 语法 W V Vv Vv 

栈 / 包 语法 V x x 

同步 API V vV Vv VvV 

异步 API x Vv vV v 

支持 移动 平台 部 分 部 分 V 部 分 

通过 微软 测试 Vv x x 


8.1 不 可 变 栈 和 队列 


问题 


需要 一 个 不 会 经 常 修改 、 可 以 被 多 个 线程 安全 访问 的 栈 或 队列 。 
例如 ， 可 用 来 表示 一 系列 操作 的 队列 ， 可 用 来 表示 一 系列 取消 操作 的 栈 。 


解决 方案 


不 可 变 栈 和 队列 是 最 简单 的 不 可 变 集合 。 它 们 的 特征 与 标准 的 Stack<T> 和 Queue<T> 非常 














相似 。 在 性 能 上 ， 不 可 变 栈 和 队列 与 标准 栈 和 队列 具有 一 样 的 时 间 复 杂 度 。 但 是 在 需要 频 
党 修改 的 简单 情况 下 ， 标 准 栈 和 队列 的 速度 更 快 。 














栈 是 “后 进 先 出 ”的 数据 结构 。 下 面 的 代码 创建 一 个 空 的 不 可 变 栈 ， 接 着 压 入 两 个 项 目 ， 
枚 举 这 些 项 目 ， 最 后 弹出 项 目 : 











var stack = ImmutableStack<int>.Empty; 
stack = stack.Push(13); 
stack = stack.Push(7); 


// 先 显 示 “7”， 接 着 显示 “13”，。 
foreach (var item in stack) 
Trace.WriteLine(item); 








int LastItem; 
stack = stack.Pop(out lastItem); 
// LastItem == 7 





在 上 面 的 例子 中 ， 值 得 注意 的 是 ， 程 序 对 局 部 变量 stack 进行 了 覆盖 。 不 可 变 集合 采用 的 
模式 是 返回 一 个 修改 过 的 集合 ， 原 始 的 集合 引用 是 不 变化 的 。 这 意味 着 ， 如 果 引 用 了 特定 
的 不 可 变 集合 的 实例 ， 它 是 不 会 变化 的 ， 具体 可 看 下 面 的 例子 : 




















var stack = ImmutableStack<int>.Empty; 
stack = stack.Push(13); 
var biggerStack = stack.Push(7); 


// 先 显 示 “7”， 接 着 显示 “13”。 
foreach (var item in biggerStack) 
Trace.WriteLine(item); 











// 只 显示 “13”。 
foreach (var item in stack) 
Trace.WriteLine(item); 


两 个 栈 实际 上 在 内 部 共享 了 存储 项 目 13 的 内 存 。 这 种 实现 方式 的 效率 很 高 ， 并 且 可 以 很 
方便 地 创建 当前 状态 的 快照 。 每 个 不 可 变 集合 的 实例 都 是 绝对 线程 安全 的 ， 但 也 能 在 单线 
程 程序 中 使 用 。 根 据 我 的 经 验 ， 如 果 代 码 功 能 增加 ， 或 者 需要 存储 很 多 快照 并 希望 它们 能 
尽 可 能 多 地 共享 内 存 ， 那 不 可 变 集 合 就 特别 有 用 。 


队列 与 栈 类 似 ， 但 队列 是 “先进 先 出 ”的 数据 结构 。 下 面 的 代码 创建 一 个 空 的 不 可 变 队 
列 ， 然 后 加 入 两 个 项 目 ， 枚 举 这 些 项 目 ， 最 后 把 项 目 从 队列 中 取出 : 



































var queue = ImmutableQueue<int>.Empty; 
queue = queue.Enqueue(13); 
queue = queue.Enqueue(7); 


// 先 显示 “13”， 接 着 显示 “7”。 
foreach (var item in queue) 
Trace.WriteLine(item); 





int nextItem; 

queue = queue.Dequeue(out nextItem) ; 
// 显示 “13”。 
Trace.WriteLine(nextItem); 


讨论 

本 市 介绍 了 两 个 最 简单 的 不 可 变 集合 : 栈 和 队列 。 也 介绍 了 几 个 适用 于 所 有 不 可 变 集 合 的 
重要 设计 理念 。 

。 不 可 变 集合 的 一 个 实例 是 永远 不 改变 的 。 

。 因为 不 会 改变 ， 所 以 是 绝对 线程 安全 的 。 

。 对 不 可 变 集合 使 用 修改 方法 时 ， 返 回 修改 后 的 集合 。 





不 可 变 集合 非常 适用 于 共享 状态 ， 但 不 适合 用 来 做 交换 数据 的 通道 。 特 别 是 在 线程 间 的 通 
信 中 不 要 使 用 不 可 变 队 列 ， 可 以 改 用 生产 者 / 消费 者 队列 ， 以 获得 更 好 的 效果 。 


ImmutabLeStack<T> 和 ImmutabLeQueue<T> 在 NuGet 包 Microsoft.Bcl. 
Immutable 中 。 








8.6 节 介 绍 线程 安全 (阻塞) 的 可 变 队列 。 
8.7 节 介绍 线程 安全 (阻塞 ) 的 可 变 栈 。 
8.8 节 介 绍 兼容 异步 操作 的 可 变 队 列 。 
8.9 节 介 绍 兼容 异步 操作 的 可 变 栈 。 








8.10 节 介 绍 阻塞 / 异步 的 可 变 队 列 。 


8.2 不 可 变 列表 

问题 

需要 一 个 这 样 的 数据 结构 : 支持 索引 ， 不 经 常 修 改 ， 可 以 被 多 个 线程 安全 访问 。 
列表 是 多 功能 数据 结构 ， 可 用 于 所 有 类 型 的 程序 状态 。 








解决 方案 
不 可 变 列表 确实 可 以 索引 ， 但 需要 注意 性 能 问题 。 不 能 简单 地 用 它 来 替代 List<T>。 
ImmutableList<T> 支持 与 List<T> 类 似 的 方法 ， 看 下 面 的 例子 ; 

var list = ImmutableList<int>.Empty; 

list = list.Insert(0, 13); 

list = list.Insert(0, 7); 

// 先 显示 “13”， 接 着 显示 “7”。 

foreach (var item in list) 

Trace.WriteLine(item); 

list = list.RemoveAt(1); 
不 可 变 列表 的 内 部 是 用 二 又 树 组 织 数 据 的 。 这 么 做 是 为 了 让 不 可 变 列表 的 实例 之 间 共 享 的 内 
存 最 大 化 。 这 导致 InmutableList<T> 和 List<T> 在 常用 操作 上 有 性 能 上 的 差别 (参见 表 8-5)。 


表 8-5: 不 可 变 列表 的 性 能 差异 











操 作 List<T> ImmutableList<T> 
Add 平 挫 0(1) O(log N) 
Insert O(N) O(log N) 
RemoveAt O(N) O(log N) 
Item[index] O(1) O(log N) 


需要 特别 注意 的 是 ，ImmutableList<T> 索引 操作 的 时 间 复 杂 度 是 O(log N)， 大 家 可 能 会 误 
以 为 是 0(1)。 如 果 在 已 有 的 代码 中 用 ImmutableList<T> 来 代替 Litst<T>， 需 要 弄 清楚 算法 
逻辑 是 如 何 访问 集合 中 元 素 的 。 











这 意味 着 应 该 尽量 使 用 foreach 而 不 是 用 for。 对 ImmutableList<T> 进行 foreach 循环 的 耗 
时 是 OOV)， 而 对 同一 个 集合 进行 for 循环 的 耗 时 是 OUVxlogN); 





// 遍历 ImmutableList<T> 的 最 好 方法 。 

foreach (var item in list) 
Trace.WriteLine(item); 

// 这 个 方法 运行 正常 ， 但 速度 会 慢 得 多 。 

for (int i = 0; i != list.Count; ++i) 
Trace.WriteLine(list[i]); 


讨论 

ImmutableList<T> 是 一 种 优秀 的 多 功能 数据 结构 ， 但 因为 有 性 能 上 的 差异 ， 不 能 盲目 地 用 
它 来 代替 List<T >。 上 默认 情况 下 一 般 使 用 List<T >， 就 是 说 ,通常 都 要 使 用 List<T>， 除 非 
确实 需要 使 用 其 他 集合 。ImmutableList<T> 的 使 用 就 没 那 么 普遍 ， 需 要 仔细 考虑 其 他 不 可 
































ImmutableList<T> 在 NuGet 包 Microsoft.Bcl.Immutable 中 。 








参阅 
8.1 市 介绍 不 可 变 栈 和 队列 ， 它 们 与 列表 类 似 ， 都 只 允许 访问 指定 的 元 素 。 
MSDN 中 有 关于 ImmutableList<T>.Builder 的 文档 ， 这 是 一 种 快速 构建 不 可 变 列表 的 方法 。 


8.3 不 可 变 Set 集 合 


问题 

需要 一 个 这 样 的 数据 结构 : 不 需要 存放 重复 内 容 ， 不 经 常 修改 ， 可 以 被 多 个 线程 安全 访问 。 
例如 ， 文 件 的 词汇 索引 就 是 使 用 Set 集合 的 一 个 实例 。 

解决 方案 

有 两 种 不 可 变 Set 人 集合 类 型 : ImmutableHashset<T> 只 是 一 个 不 含 重复 元 素 的 集合 ， 


ImmutableSortedSet<T> 是 一 个 已 排序 的 不 含 重复 元 素 的 集合 。 这 两 种 Set 集合 类 型 都 有 相 
似 的 接口 : 











var hashSet = ImmutableHashSet<int>.Empty; 
hashSet = hashSet.Add(13); 
hashSset = hashSet.Add(7); 


// 显示 “7” 和 “13”， 次 序 不 确定 。 
foreach (var item in hashSet) 
Trace.WriteLine(item); 


hashSet = hashSet.Remove(7); 
只 是 已 排序 的 Set 集合 可 以 使 用 索引 访问 ， 类 似 于 列表 ， 


var sortedSet = ImmutableSortedSet<int>.Empty; 
sortedSet = sortedSet.Add(13); 
sortedSet = sortedSet.Add(7); 


// 先 显示 “7”， 接 着 显示 “13”。 


foreach (var item in hashSet) 





Trace.WriteLine(item); 
var smallestItem = sortedSet[0]; 
// smallestItem == 7 


sortedSet = sortedSet.Remove(7); 
未 排序 的 Set 集合 和 已 排序 的 Set 集合 ， 两 者 的 性 能 差不多 ( 见 表 8-6)。 
表 8-6: 不 可 变 Set 集 合 的 性 能 








操 作 ImmutableHashSet<T> ImmutableSortedSet<T> 
Add O(log N) O(log N) 
Remove O(log N) O(log N) 
Item[index] 不 可 用 O (log N) 














如 有 果 不 是 一 定 要 排序 ， 我 建议 大 家 使 用 未 排序 的 Set 集合 。 有 些 类 型 只 支持 判断 是 否 相 等 ， 
而 不 支持 比较 大 小 ， 因此 未 排序 Set 集合 支持 的 类 型 比 已 排序 Set 集合 要 多 得 多 。 


关于 已 排序 Set 集合 有 一 点 要 特别 注意 ， 全 宁 引 各 人 亲本 复杂 度 是 O(log N)， 而 不 是 
0(1)， 这 跟 8.2 节 中 ImmutableList<T> 的 情况 类 似 。 这 意味 着 它们 适用 同样 的 警告 ,使 用 
ImmutableSortedSet<T> 时 ， 应 该 尽量 用 foreach 而 不 是 用 for。 





讨论 

不 可 变 Set 集合 是 非常 实用 的 数据 结构 ， 但 是 填充 较 大 不 可 变 Set 集合 的 速度 会 很 慢 。 大 
多 数 不 可 变 集合 有 特殊 的 构建 方法 ， 可 以 先 快速 地 以 可 变 方式 构建 ， 然 后 转换 成 不 可 变 集 
合 。 这 种 构建 方法 可 用 于 很 多 不 可 变 集合 ， 但 我 发 现 对 不 可 变 Set 集合 是 最 有 用 的 。 





ImmutabLeHashSet<T> 和 ImmutabLeSortedSet<T> 在 NuGet 包 Microsoft.Bcl. 
Immutable 中 。 








参阅 
8.7 节 介 绍 线程 安全 的 可 变 包 ， 与 Set 集合 类 似 。 
8.9 市 介绍 兼容 异步 操作 的 可 变 包 








MSDN 中 有 关于 ImmutableHashSet<T>.Builder 的 文档 ， 这 是 一 种 快速 构建 不 可 变 Set 集合 
的 方法 。 


MSDN 中 有 关于 ImmutableSortedSet<T>.Builder 的 文档 ， 这 是 一 种 快速 构建 已 排序 不 可 变 
Set 集合 的 方法 。 





8.4 不 可 变 字 典 


问题 
需要 一 个 不 经 常 修改 且 可 被 多 个 线程 安全 访问 的 键 / 值 集合 。 
例如 需要 存储 查询 集合 中 的 参考 数据 。 这 些 参考 数据 很 少 修改 但 需要 被 不 同 的 线程 访问 。 


LE 
解决 方案 
有 两 种 不 可 变 字 典 类 型 ， ImmutabLeDictionary<TKey ,TVaLue> 和 ImmutableSortedDictionar 


y<TKey,TVaLue>。 也 许 你 已 经 猜 到 了 , ImmutableSortedDictionary 确保 它 的 元 素 是 已 经 排序 
的 ， 而 ImmutableDictionary 的 元 素 次 序 是 无 法 预知 的 。 


这 两 种 集合 类 型 的 成 员 非常 相似 : 


var dictionary = ImmutableDictionary<int, string>.Empty; 

dictionary = dictionary.Add(10, "Ten"); 

dictionary = dictionary.Add(21, "Twenty-One"); 

dictionary = dictionary.SetItem(10, "Diez"); 

// 显示 “10Diez” 和 “21Twenty-0ne”， 次 序 不 确定 。 

foreach (var item in dictionary) 
Trace.WriteLine(item.Key + item.Value); 


var ten = dictionary[10]; 
// ten == "Diez" 


dictionary = dictionary.Remove(21); 





注意 SetIten 的 用 法 。 在 可 变 字典 中 ， 可 以 使 用 这 样 的 语句 : dictionary[key] = item。 但 
是 不 可 变 字典 必须 返回 一 个 更 新 后 的 不 可 变 字典 ， 因 此 用 SetIten 方法 来 代替 : 














var sortedDictionary = ImmutableSortedDictionary<int, string>.Empty; 
sortedDictionary = sortedDictionary.Add(10, "Ten"); 

sortedDictionary = sortedDictionary.Add(21, "Twenty-One"); 
sortedDictionary = sortedDictionary.SetItem(10, "Diez"); 


// 先 显示 “10Diez”， 接 着 显示 “21Twenty-0ne”。 
foreach (var item in sortedDictionary) 


Trace.WriteLine(item.Key + item.Value); 


var ten = sortedDictionary[10]; 
// ten == "Diez" 


sortedDictionary = sortedDictionary.Remove(21); 





未 排序 字典 和 已 排序 字典 在 性 能 上 差别 不 大 ， 但 是 我 建议 大 家 使 用 未 排序 字典 ， 除 非 是 必 





须 排序 ( 见 表 8-7)。 未 排序 字典 的 速度 稍微 快 一 点 。 而 且 未 排序 字典 可 以 使 用 任何 键 类 
型 ， 而 已 排序 字典 要 求 键 的 类 型 必须 是 完全 可 比较 的 。 














表 8-7: 不 可 变 字 典 的 性 能 





操 作 ImmutableDictionary<TK,TV> ImmutableSortedDictionary<TK,TV> 
Add O(log N) O(log N) 

SetItem O(log NM) O(log NM) 

Item[key] O(log N) O(log N) 

Remove O(log N) O(log NM) 

讨论 


根据 经 验 ， 字 典 是 处 理应 用 状态 时 很 普遍 又 实用 的 工具 。 它 能 用 在 任何 类 型 的 键 / 值 或 查询 。 


跟 其 他 不 可 变 集 合 一 样 ， 不 可 变 字典 有 一 个 在 元 素 较 多 时 进行 快速 构建 的 机 制 。 例 如 ， 想 
要 在 启动 时 装载 初始 参考 数据 ， 就 可 以 使 用 这 种 构建 机 制 构 造 出 初始 的 不 可 变 字典 。 相 
反 ， 如 果 参 考 数 据 是 在 程序 运行 时 逐步 构建 的 ， 那 可 以 使 用 常规 的 Add 方法 。 























ImmutabLeDictionary<TK，TV> 和 ImmutableSortedDicationary<TK，TV> 在 
NuGet 包 Microsoft.Bcl.Immutable 中 。 








参阅 


8.5 节 介 绍 线程 安全 的 可 变 字 典 。 





MSDN 中 关于 ImmutableDictionary<TK,TV>.Builder 的 文档 ， 介 绍 了 快速 填充 不 可 变 字典 
的 方法 。 





MSDN 中 关于 ImmutableSortedDictionary<TK,TV>.Builder 的 文档 ， 介 绍 了 快速 填充 已 排 
序 的 不 可 变 字典 的 方法 。 


8.5 ”线程 安全 字典 

问题 

需要 有 一 个 键 / 值 集合 ， 多 个 线程 同时 读 写 时 仍 能 保持 同步 。 
例如 一 个 简单 的 驻 留 内 存 缓存 。 








解决 方案 
.NET 中 的 ConcurrentDictionary<TKey， TVaLue> 类 是 数据 结构 中 的 精品 。 它 是 线程 安全 
的 ， 混合 使 用 了 细 粒 度 锁定 和 无 锁 技术 ， 以 确保 绝 大 多 数 情 况 下 能 进行 快速 访问 。 











熟悉 它 的 API 确 实 需要 一 定 的 时 间 。 因 为 要 处 理 多 线程 的 并 发 访问 ， 它 与 标准 的 
Dictionary<TKey,TValue> 类 完全 不 同 。 但 是 一 旦 学 完 本 节 内 容 ， 你 就 会 发 现 Concurrent 
Dictionary<TKey，TVaLue> 是 最 实用 的 集合 类 型 之 一 。 


首先 我 们 来 看 如 何在 集合 中 写 入 一 个 数据 。 要 设置 一 个 键 对 应 的 值 ， 可 使 用 Addorupdate， 
如 : 

















var dictionary = new ConcurrentDictionary<int, string>(); 
var newValue = dictionary.AddorUpdate(0， 

key => "Zero", 

(key, oldValue) => "Zero"); 


AddorUpdate 方法 有 些 复杂 ， 这 是 因为 这 个 方法 必须 执行 多 个 步 又， 具体 步骤 取决 于 并 发 
字典 的 当前 内 容 。 方 法 的 第 一 个 参数 是 键 。 第 二 个 参数 是 一 个 委托 ， 它 把 键 (本 例 中 为 
0) 转换 成 添加 到 字典 的 值 ( 本 例 中 为 “zero”)。 只 有 当 字 典 中 没有 这 个 键 时 ， 这 个 委托 
才 会 运行 。 第 三 个 参数 也 是 一 个 委托 ， 它 把 键 (0) 和 原来 的 值 转换 成 字典 中 修改 后 的 值 
(“Zero”)。 只 有 当 字 典 中 已 经 存在 这 个 键 时 ， 这 个 委托 才 会 运行 。AddorUpdate 返回 这 个 键 
对 应 的 新 值 ( 与 其 中 一 个 委托 返回 的 值 相同 )。 
有 一 点 会 让 大 家 非常 吃惊 : 为 使 并 发 字典 正常 运行 ，Addorupdate 可 能 要 多 次 调用 其 中 一 
个 (或 两 个 ) 委托 。 这 种 情况 很 少 ， 但 确实 会 发 生 。 因 此 这 些 委托 必须 简单 、 快 速 ， 并 且 
不 能 有 副作用 。 也 就 是 说 ， 这 些 委托 只 能 创建 新 的 值 ， 不 能 修改 程序 中 其 他 变量 。 这 个 原 
则 适用 于 所 有 ConcurrentDictionary<TKey ,TValue> 的 方法 所 使 用 的 委托 。 
因为 要 处 理 线程 安全 方面 的 所 有 问题 ， 这 部 分 内 容 是 比较 难 的 。 其 余 的 API 就 简单 多 了 。 
其 实 还 有 几 种 方法 可 以 向 字典 中 添加 数据 。 一 个 简便 方法 是 使 用 索引 语法 : 
// 使 用 与 上 一 个 例子 同样 的 “字典 ”。 
// 添加 (或 修改 ) 键 9， 对 应 值 “Zero”。 


dictionary[0] = "Zero"; 

























































































索引 语法 的 功能 相对 较 弱 ， 它 不 支持 根据 当前 的 值 进行 修改 的 方法 。 如 果 把 数据 直接 存 入 
字典 ， 那 使 用 这 种 语法 会 更 简单 ， 效 果 也 不 错 。 
来 看 一 下 如 何 读 取 值 。 很 简单 ， 使 用 TryGetValue 就 行 : 

// 使 用 与 前 面 一 样 的 “字典 ”。 


string currentValue; 
bool keyExists = dictionary.TryGetValue(0, out currentValue); 








如 果 字 典 中 存在 这 个 键 ，TryGetValue 返回 true， 并 填写 输出 的 变量 。 如 果 键 不 存在 ， 
TryGetValue 返回 false。 也 可 以 使 用 索引 语法 来 读 取 值 ， 但 我 发 现 这 不 怎么 实用 ， 因 为 如 
果 在 键 不 存在 ， 就 会 扫 出 异常 。 需 要 注意 ， 有 多 个 线程 在 对 并 发 字典 进行 读 取 、 修 改 、 添 
加 和 删除 值 的 操作 。 不 试 着 读 取 一 下 ， 很 多 情况 下 是 很 难 确定 某 个 键 是 否 存在 的 。 


删除 值 的 操作 跟 读 取 一 样 简单 : 









































// 使 用 与 前 面 一 样 的 “3 
string removedValue; 
bool keyExisted = dictionary.TryRemove(0, out removedValue); 


浅 


TryRemove 几乎 和 TryGetValue 一 样 ， 除 了 (当然 了 ) 它 是 进行 删除 操作 的 ， 如 果 键 存在 ， 
就 删除 “ 键 / 值 ”对 。 


外 * 八 

讨论 

我 觉得 ConcurrentDictrionary<TKey,TValue> 是 一 个 很 好 的 类 ， 主 要 是 因为 有 功能 特别 强 
大 的 Addorupdate 方法 。 但 是 它 并 不 适合 于 所 有 场合 。 如 果 多 个 线程 读 写 一 个 共享 集合 ， 
使 用 ConcurrentDictrionary<TKey,TValue> 是 最 合适 的 。 如 果 不 会 频繁 修改 (很 少 修改 )， 
那 更 适合 使 用 ImmutabLeDictionary<TKey，TVaLue>。 




















ConcurrentDictrionary<TKey,TValue> 最 适合 用 在 需要 共享 数据 的 场合 ， 即 多 个 线程 共享 同 
一 个 集合 。 如 果 一 些 线程 只 添加 元 素 ， 另 一 些 线程 只 移 除 元 素 ， 那 最 好 使 用 生产 者 / 消费 
者 集合 。 


ConcurrentDictrionary<TKey,TValue> 并 不 是 唯一 的 线程 安全 集合 。BCL 库 还 提供 了 
ConcurrentStack<T>、ConcurrentQueue<T> 和 ConcurrentBag<T>。 不 过 它们 很 少 单独 使 用 ， 
一 般 只 是 用 来 实现 生产 者 / 消费 者 集合 ， 本 章 后 面 会 介绍 。 











参阅 


8.4 市 介绍 了 不 可 变 字 典 。 如 字典 内 容 极 少 修改 ， 不 可 变 字 典 则 是 最 理想 的 选择 。 
8.6 ”阻塞 队列 


问题 


需要 有 一 个 管道 ， 在 线程 乙 间 传递 消息 或 数据 。 例 如 ， 一 个 线程 正在 装载 数据 ， 装 载 的 同 
时 把 数据 压 进 管道 。 与 此 同时 ， 另 一 个 线程 在 管道 的 接收 端 接收 并 处 理 数据 。 











解决 方案 
.NET 的 BLockingCoLtLection<T> 类 可 用 作 这 种 管道 。BlockingCollection<T> 默认 是 阻塞 队 
列 ， 具 有 “先进 先 出 ”的 特征 。 





因为 阻塞 队列 要 被 多 个 线程 共用 ， 通 常 把 它 定 义 成 私有 和 只 读 : 


private readonly BlockingCollection<int> _bLockingQueue = 
new BlockingCollection<int>(); 


通常 一 个 线程 要 么 向 集合 中 添加 项 目 ， 要 么 移 除 项 目 ， 但 不 会 两 者 都 做 。 添 加 项 目的 线程 
为 生产 者 线程 ， 移 除 项 目的 线程 为 消费 者 线程 。 


生产 者 线程 通过 调用 Add 方法 来 添加 项 目 ， 在 添加 完成 ( 即 所 有 项 目 都 已 经 添加 完毕 ) 后 
调用 CommpleteAdding 方法 。 这 个 方法 通知 集合 ， 表 示 “ 没 有 更 多 的 项 目 需要 添加 了 ” ， 然 
后 该 集合 会 通知 消费 者 线程 。 

在 下 面 的 简单 例子 中 ， 生 产 者 添加 两 个 项 目 ， 然 后 做 “完成 ”的 标志 : 


_blockingQueue.Add(7); 
_blockingQueue.Add(13); 
_blockingQueue.CompleteAdding(); 











消费 者 线程 通常 运行 一 个 循环 ， 等 待 下 一 个 项 目 然后 处 理 该 项 目 。 若 使 用 上 述 生产 者 代码 
并 放 在 独立 的 线程 里 (例如 用 Task.Run) ， 就 可 以 用 下 面 的 方法 使 用 这 些 项 目 了 : 























// 先 显示 “7”， 后 显示 “13”。 
foreach (var item in _blockingQueue.GetConsumingEnumerable()) 
Trace.WriteLine(item); 

















如 果 想 要 有 多 个 消费 者 ， 可 以 在 多 个 线程 中 同时 调用 GetConsumingEnumerabte。 每 个 项 目 
只 会 传 给 其 中 的 一 个 线程 。 当 集合 处 理 完毕 后 ， 这 个 枚 举 过 程 也 结束 。 


除非 能 保证 消费 者 的 速度 总 是 比 生 产 者 快 ， 使 用 这 种 管道 时 ， 都 要 考虑 一 旦 生产 者 比 
消费 者 快 ， 会 发 生 什么 情况 。 如 果 生 产 项 目的 速度 比 消 费 快 ， 就 需要 对 队列 进行 限 流 。 
BlockingCollection<T> 类 可 以 很 方便 地 实现 限 流 功能 ， 可 以 在 创建 队列 时 设置 限 流 的 项 目 
个 数 。 下 面 的 例子 把 集合 的 项 目 数量 限制 为 1 个: 

















BlockingCollection<int> _blockingQueue = new BlockingCollection<int>( 
boundedCapacity: 1); 


这 样 ， 同 样 的 生产 者 代码 的 运行 方式 就 会 不 同 ， 具 体 看 代码 中 的 注释 : 


// 这 个 添加 过 程 立 即 完成 。 
_bLockingQueue .Add(7); 


// 7 被 移 除 后 ， 添 加 13 才 会 完成 。 





_blockingQueue.Add(13); 


_blockingQueue.CompleteAdding(); 


讨论 
前 面 例子 中 的 消费 者 线程 都 使 用 了 GetConsumingEnumerable 方 法。 这 是 最 常用 的 做 法 ， 但 
也 可 使 用 Take 方法 ， 它 每 次 只 会 消费 一 个 项 目 ， 而 不 是 用 一 个 循环 使 用 所 有 的 项 目 。 


如 果 有 独立 的 线程 〈 如 线程 地 线程 ) 作为 生产 者 或 消费 者 ， 阻 塞 队列 就 是 一 个 十 分 不 错 的 
选择 。 如 果 要 以 异步 方式 访问 管道 ， 例 如 UI 线程 作为 消费 者 ， 用 阻塞 队列 就 不 大 合适 了 。 
8.8 节 会 介绍 异步 队列 。 


如 采 准 备 在 程序 中 使 用 这 样 的 管道 ， 可 考虑 改 用 TPL 数据 流 库 。 在 很 多 情况 下 ， 使 用 TPL 
数据 流 会 比 自己 创建 管道 和 后 台 线 程 要 简单 。 特 别 是 BufferBlock<T> 可 以 作为 阻塞 队列 使 
用 。 不 过 ， 并 不 是 每 个 平台 都 支持 TPL 数据 流 的 ， 对 那些 不 支持 TPL 数据 流 的 平台 来 说 ， 
选择 阻塞 队列 是 很 适用 的 。 








| 




















如 果 要 有 最 好 的 跨 平 台 支 持 , 也 可 以 使 用 AsyncEx 库 中 的 AsyncProducerConsumerQueue<T>， 
它 可 以 用 作 阻 塞 队 列 。 表 8-8 列 出 了 各 平台 对 阻塞 队列 的 支持 情况 。 


表 8-8: 各 平台 对 阻塞 队列 的 支持 情 ) 





平 人 BLockingCoLLection<T> BufferBLock<T> AsyncProducerConsumerQueue<T> 
.NET 4.5 Vv AAA WA 
.NET 4.0 AAA x Vv 
Mono 1OS/Droid Vv WA vV 
Windows Store ~v WA WA 
Windows Phone v WA WA 
Apps 8.1 

Windows Phone x V Vv 
SL 8.0 

Windows Phone x x V4 
SL7.1 

Silverlight 5 x x Vv 
参阅 


8.7 节 介 绍 了 阻塞 栈 和 包 ， 它 们 也 是 类 似 的 管道 ， 但 不 是 “先进 先 出 ”的 。 
8.8 节 介 绍 具 有 异步 API 而 不 是 阻塞 API 的 队列 。 
8.10 节 介 绍 既 有 异步 API 又 有 阻塞 API 的 队列 。 





8.7 阻塞 栈 和 包 


问题 
需要 有 一 个 管道 ， 在 线程 之 间 传 递 消息 或 数据 ， 但 不 想 (或 不 需要 ) 这 个 管道 使 用 “先进 
先 出 ”的 语义 。 


解决 方案 
在 默认 情况 下 ，.NET 中 的 Blockingcotlection<T> 用 作 阻 塞 队列 ， 但 它 也 可 以 作为 任何 类 


型 的 生产 者 / 消费 者 集合 。BLockingCottectton<T 实际 上 是 对 线程 安全 集合 进行 了 封装 ， 
实现 了 IProducerConsumerCollection<T> 接口 。 











因此 可 以 在 创建 BlockingCcollection<T> 实例 时 指明 规则 ， 可 选择 后 进 先 出 〈 栈 ) 或 无 序 
( 包 )， 如 下 例 所 示 : 


BlockingCollection<int> _blockingStack = new BlockingCollection<int>( 
new ConcurrentStack<int>()); 


BlockingCollection<int> _blockingBag = new BlockingCollection<int>( 
new ConcurrentBag<int>()); 


有 一 点 很 重要 并 需要 引起 注意 ， 就 是 这 时 已 经 出 现 了 有 关 项 目次 序 的 竞 态 条 件 。 如 果 先 运 
行 生产 者 代码 ， 后 运行 消费 者 代码 ， 那 项 目的 次 序 就 和 使 用 栈 完全 一 样 : 


// 生产 者 代码 
_blockingStack.Add(7); 
_blockingStack.Add(13); 
_blockingStack.CompleteAdding(); 


// 消费 者 代码 

// 先 显示 “13”， 后 显示 “7”。 

foreach (var item in _blockingStack.GetConsumingEnumerable()) 
Trace.NriteLine(iLtem) ; 

















但 是 如 果 生 产 者 代码 和 消费 者 代码 在 不 同 的 线程 中 (这 是 常见 情况 )， 消 费 者 会 一 直 取 得 
最 近 加 入 的 项 目 。 例 如 ， 生 产 者 加 入 7， 接 着 消费 者 取 走 7， 生 产 者 加 入 13， 接 着 消费 者 
取 走 13。 消 费 者 在 返回 第 一 个 项 目前 ， 不 会 等 待 生产 者 调用 CompLeteAdding。 


讨论 


阻塞 队列 有 关 限 流 的 注意 事项 ， 同 样 适用 于 阻塞 栈 和 包 。 如 果 生 产 者 的 速度 比 消费 者 快 ， 
又 要 限制 阻塞 栈 和 包 对 内 存 的 使 用 ， 就 可 以 使 用 8.6 市 讨论 过 的 限 流 方 法 。 


本 方 的 消费 者 代码 使 用 GetConsumingEnumerable， 这 是 最 常用 的 做 法 。 但 也 可 使 用 Take 方 








法 ， 它 每 次 只 会 消费 一 个 项 目 ， 而 不 是 用 一 个 循环 消费 掉 所 有 的 项 目 。 

















如 果 不 用 阻塞 方式 ， 而 是 要 用 异步 方式 访问 共享 的 栈 或 包 (例如 ，UI 线程 作为 消费 者 ) ， 
请 看 8.9 市 。 


参阅 

8.6 节 介绍 了 阻塞 队列 ， 它 的 使 用 比 阻塞 栈 或 包 要 广泛 得 多 。 
8.9 节 介 绍 了 异步 栈 和 包 。 

8.8 异步 队列 

问题 





需要 有 一 个 管道 ， 在 代码 的 各 个 部 分 之 间 以 后 进 先 出 的 方式 传递 消息 或 数据 。 
例如 ， 一 段 代码 在 加 载 数据 ， 并 向 管道 推送 数据 。 同 时 UI 线程 在 接收 并 显示 数据 。 
解决 方案 


只 需要 一 个 带 有 异步 API 的 队列 。 在 .NET 核心 框架 中 没有 这 样 的 类 ， 但 是 在 NuGet 中 有 
好 几 个 可 以 选择 。 











第 一 个 选择 是 使 用 TPL 数据 流 库 的 BufferBlock<T >。 下 面 的 例子 展示 了 声明 Buffer 
Block<T> 实例 的 方法 、 生 产 者 代码 和 消费 者 代码 的 样式 : 


BufferBlock<int> _asyncQueue = new BufferBlock<int>(); 


// 生产 者 代码 

await _asyncQueue.SendAsync(7); 
await _asyncQueue.SendAsync(13); 
_asyncQueue.Complete(); 





// 消费 者 代码 

// 先 显示 “7”， 后 显示 “13”。 

while (await _asyncQueue.O0utputAvailableAsync()) 
Trace.WriteLine(await _asyncQueue.ReceiveAsync()); 


BufferBlock<T> 本 身 也 支持 限 流 ， 详 见 8.10 市 。 











例子 中 消费 者 代码 使 用 了 0utputAvailableAsync， 这 个 方法 其 实 只 能 用 在 仅 有 一 个 消费 
者 的 情况 下 。 如 果 有 多 个 消费 者 ， 即 使 队列 中 只 有 一 个 项 目 ，0utputAvailableAsync 也 
可 能 对 每 个 消费 者 都 返回 true。 如 果 队 列 中 项 目 都 取 完 了 ，DequeueAsync 会 抛 出 InvatLid 
OperationException 异常 。 因 此 在 有 多 个 消费 者 时 ， 消 费 者 的 代码 通常 更 像 下 面 这 样 : 
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while (true) 


{ 
int item; 
try 
{ 


} 


catch (InvalidOperationException) 


{ 
} 


Trace.WriteLine(itenm); 


item = await _asyncQueue.ReceiveAsync(); 


break; 


} 





如 果 所 用 的 平台 支持 TPL 数据 流 ， 我 建议 大 家 使 用 BufferBlock<T> 的 方案 。 可 惜 并 不 是 所 有 
平台 都 支持 TPL 数据 流 。 如 果 平 台 不 支持 BufferBLock<T>， 那 可 以 用 NuGet 包 Nito.AsyncEx 
中 的 AsyncProducerConsumerQueue<T> 类 。 它 的 API 与 BufferBLock<T> 类 似 ， 但 不 完全 相同 : 


AsyncProducerConsumerQueue<int> _asyncQueue 
= new AsyncProducerConsumerQueue<int>(); 


// 生产 者 代码 

await _asyncQueue.EnqueueAsync(7); 
await _asyncQueue.EnqueueAsync(13); 
await _asyncQueue.CompleteAdding(); 


// 消费 者 代码 

// 先 显示 “7”， 后 显示 “13”。 

while (await _asyncQueue.OutputAvailableAsync()) 
Trace.NriteLine(await _asyncQueue.DequeueAsync()); 


AsyncProducerConsumerQueue<T> 具有 限 流 功能 ， 如 果 生 产 者 的 运行 速度 可 能 比 消费 者 快 ， 





这 个 功能 就 是 必需 的 。 只 要 在 构造 队列 时 使 用 适当 的 参数 即 可 : 





AsyncProducerConsumerQueue<int> _asyncQueue 
= new AsyncProducerConsumerQueue<int>(maxCount: 1); 


这 样 ， 同 样 的 生产 者 代码 会 以 异步 方式 正确 地 等 待 了 : 


// 这 个 添加 过 程 会 立即 完成 。 
await _asyncQueue.EnqueueAsync(7); 





// 这 个 添加 过 程 会 (异步 地 ) 等 待 ， 直 到 7 被 移 除 ， 
// 然后 才 会 加 入 13。 


await _asyncQueue.EnqueueAsync(13); 




















await _asyncQueue.CompleteAdding(); 


例子 中 的 消费 者 代码 也 使 用 0utputAvailableAsync， 并 且 也 有 跟 BufferBlock<T> 同样 的 问 
题 。AsyncProducerConsumerQueue<T> 类 提供 了 TryDequeueAsync 成 员 ， 可 以 用 来 避免 元 长 

















的 消费 者 代码 。 如 果 有 多 个 消费 者 ， 消 费 者 代码 通常 像 这 样 : 





while (true) 


{ 
var dequeueResult = await _asyncQueue.TryDequeueAsync(); 
if (!dequeueResult.Success) 
break; 
Trace.NriteLine(dequeueResuLt.Item) ; 
} 
* Bg 
讨论 





BufferBLock<T> 和 AsyncProducerConsumerQueue<T> 相 比 ， 我 更 推荐 使 用 前 者 ， 仅 仅 是 因为 
对 BufferBlock<T> 进行 的 测试 要 完整 得 多 。 但 是 有 很 多 平台 不 支持 BufferBlock<T>， 尤 其 
是 一 些 较 老 的 平台 ( 见 表 8-9)。 


表 8-9: 各 平台 对 异步 队列 的 支持 情 ) 

















平 | BufferBlock<T> AsyncProducerConsumerQueue<T> 
.NET 4.5 Vv Vv 
.NET 4.0 x Vv 
Mono iOS/Droid Vv Vv 
Windows Store WA vV 
Windows Phone Apps 8.1 WA Vv 
Windows Phone SL 8.0 vV WA 
Windows Phone SL 7.1 x Vv 
Silverlight 5 x Vv 


BufferBlock<T> 类 在 NuGet 包 Microsoft.Tpl.Dataflow 中 。AsyncProducerC 
onsumerQueue<T> 类 在 NuGet 包 Nito.AsyncEx 中 。 








参阅 

8.6 节 介 绍 了 阻塞 语义 (而 不 是 异步 语义 ) 的 生产 者 / 消费 者 队列 。 

8.10 市 介绍 了 同时 具有 阻塞 语义 和 异步 语义 的 生产 者 / 消费 者 队列 。 

8.7 市 介绍 了 异步 栈 和 包 ， 可 用 于 需要 类 似 的 管道 ， 但 不 要 先进 先 出 语义 的 场合 。 


8.9 异步 栈 和 包 


问题 
需要 一 个 管道 ， 用 来 在 程序 的 各 个 部 分 之 间 传 递 消息 或 数据 ， 但 不 希望 (或 不 需要 ) 这 个 
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管道 使 用 “先进 先 出 ”的 语义 。 


解决 方案 

Nito.AsyncEx 库 提 供 了 AsyncCollection<T> 类 ， 它 默认 表现 为 异步 队列 ， 但 也 可 以 作为 任 
何 类 型 的 生产 者 / 消费 者 集合 。AsyncCoLLection<T> 对 IProducerConsumerCoLLection<T> 进 
行 了 封装 。AsyncCoLLection<T> 相当 于 是 异步 版 的 .NET BlockingCollection<T> 类 。 


AsyncCollection<T> 支持 后 进 先 出 〈 栈 ) 或 无 序 ( 包 ) 的 语义 ， 取决 于 构造 函数 中 传 入 什 
么 集合 : 
AsyncCollection<int> _asyncStack = new AsyncCollection<int>( 
new ConcurrentStack<int>()); 


AsyncCollection<int> _asyncBag = new AsyncCollection<int>( 
new ConcurrentBag<int>()); 


注意 在 栈 的 项 目次 序 上 有 竞 态 条 件 。 如 果 所 有 生产 者 完成 后 ， 消 费 者 才 开 始 运 行 ， 那 项 目 
的 次 序 就 像 一 个 普通 的 栈 : 

// 生产 者 代码 

await _asyncStack.AddAsync(7); 


await _asyncStack.AddAsync(13); 
await _asyncStack.CompleteAddingAsync(); 


// 消费 者 代码 

// 先 显示 “13”， 后 显示 “7”。 

while (await _asyncStack.OutputAvailableAsync()) 
Trace.WriteLine(await _asyncStack.TakeAsync()); 


但 是 ， 当 生产 者 和 消费 者 都 并 发 运行 时 (这 是 常见 情况 )， 消 费 者 总 是 会 得 到 最 近 加 入 的 
项 目 。 这 导致 这 个 集合 从 整体 上 看 不 像 是 一 个 栈 。 当 然 了 ， 包 是 根本 没有 次 序 的 。 
AsyncCollection<T> 具有 限 流 功能 ， 如 果 生 产 者 添加 项 目 到 集合 的 速度 可 能 比 消费 者 从 集 
合 取 走 项 目的 速度 快 ， 这 个 功能 就 是 必需 的 。 只 要 在 构造 集合 时 使 用 合适 的 值 就 行 了 : 


AsyncCollection<int> _asyncStack = new AsyncCollection<int>( 
new ConcurrentStack<int>(), maxCount: 1); 


这 样 ， 同 样 的 生产 者 代码 会 根据 需要 异步 地 等 待 了 : 


// 这 个 添加 过 程 会 立即 完成 。 
await _asyncStack.AddAsync(7); 


// 这 个 添加 (异步 地 ) 等 待 ， 直到 7 被 移 除 ， 
// 然后 才 会 加 入 13。 
await _asyncStack.AddAsync(13); 





await _asyncStack.CompleteAddingAsync(); 
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例子 中 的 消费 者 代码 使 用 了 0utputAvailableAsync， 这 个 方法 同样 有 如 8.8 市 描写 的 那 种 
限制 。 如 果 有 多 个 消费 者 ， 消 费 者 代码 通常 更 像 这 样 : 


while (true) 


{ 
var takeResult = await _asyncStack.TryTakeAsync(); 
if (!takeResult.Success) 
break; 
Trace.WriteLine(takeResult.Item); 
} 
Bo 和 
讨论 


AsyncCollection<T> 实际 上 只 是 异步 版 的 BlockingCollection<T> 类 ， 并 且 支 持 的 平台 也 一 
样 ( 见 表 8-10) 。 


表 8-10: 各 平台 对 栈 和 包 的 支持 情 ) 











平 台 BlockingCollection<T> ( 阻塞 ) AsyncCollection<T> ( 异步 ) 
.NET 4.5 vV V 
.NET 4.0 V Vv 
Mono iOS/Droid AAA a 
Windows Store WA 
Windows Phone Apps 8.1 Vv Vv 
Windows Phone SL 8.0 x x 
Windows Phone SL 7.1 x x 
Silverlight 5 x x 


AsyncCollection<T> 类 在 NuGet 包 Nito.AsyncEx 中 。 








参阅 
8.8 节 介 绍 了 异步 队列 ， 它 的 使 用 比 异 步 栈 或 包 要 广泛 得 多 。 
8.7 节 介 绍 了 异步 (阻塞 ) 栈 和 包 。 


8.10 阻塞 /异步 队列 


问题 
需要 一 个 管道 ， 用 “先进 先 出 ”的 方式 在 程序 的 各 部 分 之 间 传 递 消息 或 数据 。 并 且 要 有 足 





够 的 灵活 性 ， 能 以 同步 或 异步 方式 来 处 理 生 产 者 终端 或 消费 者 终端 。 





例如 ， 一 个 后 台 线 程 在 装载 数据 并 把 数据 压 入 管道 ， 我 们 希望 当 管道 太 满 时 该 线程 能 同步 
地 阻塞 。 同时 ，UI 线程 在 从 管道 接收 数据 ， 我 们 希望 这 个 线程 异步 地 从 管道 拉 取 数据 ， 以 
便 UI 保持 啊 应 。 


解决 方案 
我 们 已 经 看 了 8.6 节 中 的 阻塞 队列 、8.8 节 中 的 异步 队列 ， 但 是 还 有 几 种 同时 支持 阻塞 API 
和 异步 API 的 队列 。 





首先 是 NuGet 库 TPL 数据 流 中 的 BufferBLock<T> 和 ActionBLock<T>。BufferBLock<T> 能 很 
方便 地 用 作 异 步 的 生产 者 / 消费 者 队列 ( 详 见 8.8 节 ) : 


BufferBlock<int> queue = new BufferBlock<int>(); 


// 生产 者 代码 

await queue.SendAsync(7); 
await queue.SendAsync(13); 
queue.Complete(); 


// 单个 消费 者 时 的 代码 
while (await queue.OutputAvailableAsync()) 
Trace.WriteLine(await queue.ReceiveAsync()); 


// 多 个 消费 者 时 的 代码 
while (true) 


{ 





int item; 
try 
攻 


item = await queue.ReceiveAsync(); 


catch (InvalidOperationException) 


{ 
} 


break; 


Trace.WriteLine(item); 


} 
BufferBLock<T> 也 有 用 于 生产 者 和 消费 者 的 同步 API: 
BufferBlock<int> queue = new BufferBlock<int>(); 


// 生产 者 代码 
queue.Post(7); 
queue.Post(13); 
queue.Complete(); 
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但 是 使 用 了 BufferBlock<T> 的 消费 者 代码 是 十 分 笨拙 的 ， 


// 消费 者 代码 
while (true) 
{ 
int item; 
try 


item = queue.Receive(); 


catch (InvalidOperationException) 


{ 


break; 


} 


Trace.WriteLine(item); 


} 








大 








为 这 不 是 “数据 流 的 风格 ”。 


TPL 数据 流 库 包 含 几 个 能 互相 连接 的 块 ， 可 以 定义 一 个 响应 式 网 格 。 在 本 例 中 ， 可 以 用 
ActionBlock<T> 定义 一 个 带 有 特定 动作 的 生产 者 / 消费 者 队列 : 





// 消费 者 代码 被 传 给 队列 的 构造 函数 


ActionBlock<int> queue = new ActionBlock<int>(item => Trace.WriteLine(item)); 


// 异步 的 生产 者 代码 
await queue.SendAsync(7); 
await queue.SendAsync(13); 


// 同步 的 生产 者 代码 
queue.Post(7); 
queue.Post(13); 
queue.Complete(); 


如 果 你 选 定 的 平台 不 支持 TPL 数据 流 库 ， 那 可 以 使 用 Nito.AsyncEx 中 的 AsyncProducer 
ConsumerQueue<T> 类 ， 它 同时 也 支持 同步 和 异步 方法 : 


AsyncProducerConsumerQueue<int> queue = new AsyncProducerConsumerQueue<int>(); 


// 异步 的 生产 者 代码 
await queue.EnqueueAsync(7); 
await queue.EnqueueAsync(13); 


// 同步 的 生产 者 代码 
queue.Enqueue(7); 
queue.Enqueue(13); 


queue.CompleteAdding(); 


// 单个 消费 者 时 的 异步 代码 
while (await queue.OutputAvailableAsync()) 
Trace.NriteLine(await queue.DequeueAsync()); 


// 多 个 消费 者 时 的 异步 代码 





while (true) 


{ 
var result = await queue.TryDequeueAsync(); 
if (!result.Success) 
break; 
Trace.NriteLine(resuLt.Item) ; 
} 


// 同步 的 消费 者 代码 
foreach (var item in queue.GetConsumingEnumerable()) 
Trace.WriteLine(item); 


讨论 
虽然 AsyncProducerConsumerQueue<T> 支持 更 多 的 平台 ， 我 仍 建议 大 家 尽 可 能 使 用 Buffer 
Block<T> 或 ActionBLock<T>， 因 为 对 TPL 数据 流 库 做 过 的 测试 比 Nito.AsyncEx 更 加 完整 。 


像 AsyncProducerConsumerQueue<T> 这 样 的 TPL 数据 流 块 也 支持 限 流 功能 ， 可 以 通过 传递 
构造 函数 的 参数 来 实现 此 功能 。 如 果 生 产 者 压 入 项 目的 速度 比 消费 者 消耗 项 目的 速度 块 ， 
就 会 导致 程序 占用 大 量 的 内 存 ， 这 种 情况 下 必须 使 用 限 流 功能 。 表 8-11 列 出 了 个 平台 对 同 
步 /异步 队列 的 支持 情况 。 




















表 8-11: 各 平台 对 同步 /异步 队列 的 支持 情 ) 


平台 BufferBLock<T> 和 ActionBLock<T> AsyncProducerConsumerQueue<T> 
.NET 4.5 1 AAA 
.NET 4.0 x Vv 
Mono iOS/Droid Vv Vv 
Windows Store Vv Vv 
Windows Phone Apps 8.1 Vv WA 
Windows Phone SL 8.0 Vv Vv 
Windows Phone SL 7.1 x Vv 
Silverlight 5 x vV 


BufferBLock<T> 类 和 ActionBlock<T> 类 在 NuGet 包 Microsoft.Tpl.Dataflow 
中 。AsyncProducerConsumerQueue<T> 类 在 NuGet 包 Nito.AsyncEx 中 。 








8.6 节 介 绍 了 阻塞 的 生产 者 / 消费 者 队列 。 
8.8 市 介绍 了 异步 的 生产 者 / 消费 者 队列 。 
4.4 市 介绍 了 数据 流 块 的 限 流 功能 。 
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第 9 章 


取消 





.NET 4.0 框架 引入 了 详尽 的 、 精 心 设计 的 取消 功能 。 取 消 采 用 协作 方式 ， 即 可 以 请 求 某 段 
代码 取消 ， 但 不 能 强制 它 取消 。 如 果 某 段 代码 本 身 不 支持 取消 ， 就 无 法 请 求 它 取消 运行 。 
基于 这 个 原因 ， 建 议 大 家 在 编写 代码 时 尽量 支持 取消 。 

















取消 是 一 种 信号 ， 包 含 两 个 不 同 的 方面 : 触发 取消 的 产 头 和 响应 取消 的 接收 器 。 在 .NET 
中 源头 是 CancellationTokenSource， 接 收 器 是 CancellationToken。 本 章 将 介绍 这 两 方面 
常规 用 法 ， 还 将 介绍 如 何 与 非 标准 的 取消 模式 进行 互 操作 。 


取消 被 看 作 是 一 种 特殊 类 型 的 错误 。 通 常 被 取消 的 代码 会 抛 出 类 型 为 0perationCanceled 
Exception (或 者 它 的 子 类 ， 如 TaskCanceledException) 的 异常 。 调 用 的 代码 用 这 种 方式 
确认 取消 信号 已 被 接收 。 


为 了 表明 某 个 方法 支持 取消 ， 需 要 用 一 个 CancellationToken 作为 该 方法 的 参数 。 这 个 参 
数 通常 放 在 最 后 ， 除 非 该 方法 也 支持 进度 报告 ( 见 2.3 节 )。 也 可 考虑 提供 一 个 重 载 函数 或 
一 个 参数 默认 值 ， 供 不 需要 取消 的 程序 使 用 : 














public void CancelableMethodwithOverload(CancellationToken cancellationToken) 
// 这 里 放 代 码 

public void CancelableMethodwithOverload() 

{ 

} 


CancelableMethodWwithOverload(CancellationToken.None); 
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public void CancelableMethodwithDefault( 
CancellationToken cancellationToken = default(CancellationToken)) 


{ 
3 











// 这 里 放 代 码 











CancellationToken.None 是 一 个 等 同 于 default(CancellationToken) 的 特殊 值 ， 表 示 这 个 方 
法 是 永远 不 会 被 取消 的 。 如 果 启 动 这 个 操作 后 不 准备 取消 ， 就 可 以 在 调用 时 使 用 这 个 值 。 


9.1 发 出 取消 请 求 
问题 
有 一 段 可 取消 的 代码 (使 用 了 CancellationToken)， 需 要 把 它 取 消 。 


Sa 
解决 方案 

CancellationToken 来 源 于 CancellationTokenSource 类 。CancellationToken 只 是 让 代码 能 
够 响应 取消 请 求 ， 用 CancellationTokenSource 的 用 户 可 发 出 取消 请 求 。 














多 个 CancellationTokenSource 互相 之 间 是 独立 的 (除非 把 它们 连接 起 来 ， 具体 操作 将 在 
9.8 节 介 绍 )。CancellationTokenSource 的 Token 属性 返回 它 的 CancellationToken，Cancel 


方法 发 出 真正 的 取消 请 求 。 








下 面 的 代码 展示 了 如 何 创 建 一 个 CancellationTokenSource 实例 和 如 何 使 用 Token 和 
CanceL。 用 简短 的 例子 更 容易 说 明 问 题 ， 因 此 代码 使 用 了 async 方法。 同样 的 Token/ 
Cancel 组 合 可 以 用 来 取消 所 有 类 型 的 代码 : 





void IssueCancelRequest() 


{ 
var cts = new CancellationTokenSource(); 
var task = CancelableMethodAsync(cts.Token); 


// 到 这 里 ， 操 作 已 经 启动 。 

// 发 出 取消 请 求 。 

cts.Cancel(); 

} 

在 前 面 的 例子 中 ， 当 任务 启动 后 就 把 Task 变量 忽略 了 。 在 实际 项 目的 开发 中 ， 这 个 变量 可 
能 会 被 存储 起 来 并 使 用 await 等 待 ， 以 便 最 终 用 户 能 看 到 运行 结果 。 
在 取消 任务 运行 时 通常 会 产生 竞 态 条 件 。 如 果 在 发 出 取消 请 求 的 时 刻 ， 被 取消 的 代码 即将 
完成 ， 若 来 不 及 检查 取消 标记 ， 那 它 就 会 正常 地 结束 。 在 取消 代码 时 实际 上 会 有 三 种 可 能 
性 : 响应 取消 请 求 ( 抛 出 0perationCanceLedException) ， 正 常 结束 ， 或 者 出 现 跟 取消 无 关 















































的 错误 并 结束 〈 抛 出 其 他 异常 ) 。 
下 面 的 例子 与 前 面 类 似 ， 但 使 用 了 await， 说 明了 三 种 可 能 的 结果 : 





async Task IssueCanceLRequestAsync() 














{ 
var cts = new CancellationTokenSource(); 
var task = CancelableMethodAsync(cts.Token); 
// 这 里 ， 操 作 在 正常 运行 。 
// 发 出 取消 请 求 。 
cts.Cancel(); 
// (异步 地 ) 等 待 操作 结束 。 
try 
{ 
await task; 
// 如 运行 到 这 里 ， 说 明 在 取消 请 求生 效 前 ， 操 作 正 常 完成 。 
} 
catch (OperationCanceledException) 
{ 
// 如 运行 到 这 里 ， 说 明 操 作 在 完成 前 被 取消 。 
} 
catch (Exception) 
{ 
// 如 运行 到 这 里 ,说 明 在 取消 请 求生 效 前 ， 操 作出 错 并 结束 。 
throw; 
} 
} 





创建 cancellationTokenSource 实例 和 发 出 取消 请 求 ， 这 两 步 一 般 放 在 不 同方 法 中 。 
CancellationTokenSource 实例 一 旦 销毁 就 无 法 恢复 。 如 果 需 要 另 一 个 取 背 标记 源 ， 就 必须 




















创建 另 一 个 实例 。 下 面 是 一 个 更 接近 实际 开发 的 GUI 界面 的 例子 ， 


用 一 个 按钮 启动 异步 操 


作 ， 另 一 个 按钮 用 来 取消 这 个 操作 。 程 序 会 禁用 或 启用 “开始 ”和 “取消 ”这 两 个 按钮 ， 


以 保证 同一 时 间 内 只 有 一 个 操作 : 


private CancellationTokenSource _cts; 


private async void StartButton Click(object sender, RoutedEventArgs e) 


{ 
StartButton.IsEnabled = false; 
CancelButton.IsEnabled = true; 


try 
{ 
_Ccts = new CancellationTokenSource(); 
var token = _cts.Token; 
await Task.Delay(TimeSpan.FromSeconds(5), token); 
MessageBox.Show("Delay completed successfully."); 


和 


catch (OperationCanceledException) 
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{ 


MessageBox.Show("Delay was canceled."); 


catch (Exception) 


{ 
MessageBox.Show("Delay completed with error."); 
throw; 
} 
finally 
StartButton.IsEnabLed = true; 
CancelButton.IsEnabled = false; 
} 
} 
private void CancelButton_Click(object sender, RoutedEventArgs e) 
{ 
_cts.Cancel(); 
} 
* * 八 
讨论 


本 市 用 一 个 GUI 程序 作为 最 接近 实际 开发 的 例子 ， 但 不 要 误 以 为 只 有 用 户 界面 程序 才能 


用 取消 。 取 
服务 器 端的 


消 也 可 用 在 服务 器 程序 中 ， 例 如 ASP.NET 中 有 一 个 表示 请 求 超时 的 取消 标记 。 
取消 标记 浙 确 实 很 少 ， 但 是 没有 理由 说 不 能 用 。 我 就 曾 在 ASP.NET 将 要 邱 载 





应 用 程序 域 时 ， 用 一 个 CancellationTokenSource 来 请 求 取消 。 


参阅 

9.4 市 介绍 妇 
9.5 市 介 绍 妇 
9.6 市 介 绍 妇 


9.7 市 介绍 妇 


0 何 向 async 代码 传递 取消 标记 。 
Pp 何 向 并 发 代码 传递 取消 标记 。 

H 何 向 响应 式 代码 传递 取消 标记 。 
H 何 向 数据 流 网 格 传递 取消 标记 。 








9.2 ”通过 轮 询 响 应 取消 请 求 


问题 


在 代码 的 循环 中 实现 取消 。 


解决 方案 


代码 中 正在 运行 一 个 循环 时 ， 就 没有 更 低级 别 的 API 来 接收 CancellationToken 了 。 这 时 








可 以 周期 性 地 检查 标记 是 否 已 被 取消 。 下 面 的 代码 在 运行 计算 密集 型 的 循环 时 ， 周 期 性 地 
监测 标记 : 











public int CancelableMethod(CancellationToken cancellationToken) 


{ 


for (int i = 0; i != 100; ++i) 


Thread.SLeep(1000); // 这 里 做 一 些 计 算 工 作 。 
cancellationToken.ThrowIfCancellationRequested(); 


| 


return 42; 


} 
如 果 循 环 很 密集 ( 即 循环 体 的 运行 速度 很 快 )， 就 需要 限制 检查 取消 标记 的 频率 。 在 确定 
最 佳 做 法 之 前 ， 通 常 要 对 此 类 修改 前 后 的 程序 性 能 进行 评估 。 下 面 的 代码 与 上 一 个 例子 类 
似 ， 但 是 循环 速度 更 快 、 次 数 更 多 ， 因 此 对 检查 标记 的 频率 进行 了 限制 : 























public int CancelableMethod(CancellationToken cancellationToken) 
{ 
for (int i = 0; i != 100000; ++i) 
{ 
Thread.SLeep(1); // 这 里 做 一 些 计算 工作 。 
if (i % 1000 == 0) 
cancellationToken.ThrowIfCancellationRequested(); 


return 42; 
} 
限制 多 少 才 是 合适 的 ， 这 完全 取决 于 代码 工作 量 的 大 小 ， 以 及 对 响应 速度 的 要 求 。 
讨论 
大 多 数 情况 下 ， 只 需要 把 CancellationToken 传递 给 下 一 层 就 行 了 。9.4 市 至 9.7 节 有 这 方 
看 的 例子 。 只 有 要 求 在 循环 代码 中 支持 取消 时 ， 才 需要 轮 询 检查 标记 。 


























CancellationToke 类 还 有 一 个 成 员 IsCancellationRequested， 它 会 在 标记 被 取消 后 返回 
true。 有 些 人 使 用 这 个 成 员 来 响应 取消 请 求 ， 即 通常 返回 一 个 默认 值 或 nutl。 不 过 我 一 
般 并 不 推荐 这 种 做 法 。 处 理 取消 请 求 的 标准 模式 是 抛 出 一 个 0perationCanceledException 
异常 ， 这 个 过 程 由 ThrowIfCancellationRequested 来 负责 。 如 果 更 进一步 的 代码 要 捕获 
这 个 异常 ， 并 且 处 理 结 果 为 null 的 情况 ， 那 这 种 做 法 就 没 问 题 。 但 如 果 代 码 完 全 控制 了 
CancellationToken， 就 该 遵循 处 理 取 消 请 求 的 标准 模式 。 如 果 人 确实 不 想 遵循 标准 模式 ， 至 
少 要 有 详细 的 描述 。 


























通过 轮 询 取消 标记 使 ThrowIfCanceLLationRequested 起 效 ， 代 码 中 必须 以 固定 间隔 调用 这 
个 方法 。 还 有 一 种 做 法 是 注册 一 个 回调 函数 ， 收 到 取消 请 求 时 会 被 调用 。 这 种 用 回调 函数 
的 做 法 更 像 是 与 其 他 取消 体系 的 互 操作 ， 因 此 我 们 把 它 放 到 9.9 节 。 


























参阅 
9.4 节 介 绍 如 何 问 async 代码 传递 取消 标记 。 
9.5 节 介绍 如 何 向 并 发 代码 传递 取消 标记 。 





9.6 市 介绍 如 何 向 响应 式 代码 传递 取消 标记 。 
9.7 市 介绍 如 何 向 数据 流 网 格 传递 取消 标记 。 
9.9 布 介绍 如 何 用 回调 函数 代替 轮 询 ， 来 响应 取消 请 求 。 











9.1 市 介绍 如 何 发 出 取消 请 求 。 


9.3 超时 后 取消 


问题 
需要 让 一 些 代码 在 发 生 超时 后 停止 运行 。 
解决 方案 


发 生 超时 后 ， 取 消 便 是 一 种 很 自然 的 解决 方案 。 超时 只 是 一 种 取消 请 求 的 类 型 。 需 要 取消 的 
代码 仅仅 监视 取消 标记 ， 不 管 取消 的 类 型 ， 代 码 不 知道 也 不 关心 取消 的 来 源 是 一 个 定时 器 。 


.NET 4.5 为 取消 标记 源 添 加 了 几 个 便捷 的 方法 ， 这 些 方 法 会 基于 定时 器 自动 发 出 取消 请 
求 。 可 以 把 超时 数据 传 给 构造 函数 : 


async Task IssueTimeoutAsync() 


{ 
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5)); 
var token = cts.Token; 
await Task.Delay(TimeSpan.FromSeconds(10), token); 

} 





还 有 一 个 方案 ， 如 果 已 经 有 了 一 个 CancellationTokenSource 实例 ， 可 以 对 该 实例 启动 一 个 
超时 : 


async Task IssueTimeoutAsync() 


{ 
var cts = new CancellationTokenSource(); 
var token = cts.Token; 
cts.CancelAfter(TimeSpan.FromSeconds(5)); 
await Task.Delay(TimeSpan.FromSeconds(10), token); 
} 
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.NET 4.0 不 支持 采用 构造 国 数 的 方案 ， 但 是 该 平台 的 NuGet 包 Microsoft.Bcl.Async 支持 
CancelAfter 方法 。 
讨论 

只 要 执行 代码 时 用 到 了 超时 ， 就 该 使 用 CancellationTokenSource 和 CanceLAfter (或 者 用 


构造 函数 )。 虽 然 还 有 其 他 途径 可 实现 这 个 功能 ， 但 是 使 用 现 有 的 取消 体系 是 最 简单 也 是 
最 高 效 的 。 


别 忘 了 被 取消 的 代码 需要 监视 取消 标记 。 不 支持 取消 的 代码 ， 是 不 可 能 被 轻易 取消 的 。 


9.4 布 介绍 如 何 向 async 代码 传递 取消 标记 。 

可 向 并 发 代码 传递 取消 标记 。 

9.6 市 介绍 如 何在 响应 式 代码 中 使 用 取消 标记 。 
可 向 数据 流 网 格 传递 取消 标记 。 


9.4 取消 async 人 代码 


问题 
需要 让 async 代码 支持 取消 。 


解决 方案 
要 使 异步 代码 支持 取消 ， 最 简单 的 办 法 就 是 把 cancettattonToken 传递 给 下 一 层 代码 。 这 


个 例子 执行 一 个 异步 的 延 时 ， 然 后 返回 一 个 值 。 它 只 是 把 标记 传递 给 Task.Delay， 就 实现 
了 对 取消 的 支持 : 
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public async Task<int> CancelableMethodAsync(CancellationToken cancellationToken) 


{ 
await Task.Delay(TimeSpan.FromSeconds(2), cancellationToken); 
return 42; 


} 


很 多 异步 API 都 支持 CancellationToken， 因 此 在 程序 中 实现 取消 是 很 容易 的 ， 只 需要 将 
标记 传递 下 去 即 可 。 这 有 一 个 通用 的 准则 ， 如 果 一 个 方法 调用 了 支持 CancellationTaken 
的 API， 那 这 个 方法 也 要 支持 CancellationToken 并 把 它 传 给 每 个 支持 它 的 API。 

















讨论 

很 可 异 ， 有 一 些 方法 是 不 支持 取消 的 。 没 有 简单 的 解决 方案 可 处 理 这 种 情况 。 要 安全 地 停 
止 这 种 “专横 的 ”代码 是 不 可 能 的 ， 除 非 把 它 封装 在 一 个 独立 的 可 执行 程序 中 。 碰 到 此 类 
情况 ， 你 可 以 选择 忽略 它 的 返回 结果 ， 假 装 已 经 取消 了 这 个 操作 。 



































只 要 有 可 能 ， 每 个 方法 都 要 支持 取消 以 供 调用 者 选择 使 用 。 这 是 因为 只 有 较 低层 次 的 代码 
正确 地 支持 取消 ， 较 高 层次 的 代码 才 有 可 能 正确 地 支持 取消 。 因 此 在 编写 自己 的 async 方 
法 时 ， 要 尽 最 大 可 能 支持 取消 。 你 无 法 预料 哪个 较 高 层次 的 方法 会 调用 你 的 方法 ， 而 该 方 
法 可 能 需要 支持 取消 。 











参阅 
9.1 节 介 绍 如 何 发 出 取消 请 求 。 
9.3 节 介 绍 把 取消 用 作 超 时 。 
Re 内 一 已 
9.5 取消 并 行 代码 
问题 
需要 让 并 行 代码 支 持 取 消 。 
解决 方案 
要 支持 取消 ， 最 简单 的 方法 是 把 CancellationToken 传递 进 并 行 代码 。 并 行 方法 使 用 


Parallel 0ptions 实例 来 支持 取消 。 可 以 用 下 面 的 方法 设置 Paralleloptions 实例 的 


CancellationToken.: 














static void RotateMatrices(IEnumerable<Matrix> matrices, float degrees, 
CancellationToken token) 


{ 
Parallel.ForEach(matrices, 
new ParallelOptions { CancellationToken = token }, 
matrix => matrix.Rotate(degrees)); 
} 


另 一 个 方法 在 循环 体 中 直接 监视 CancellationToken: 


static void RotateMatrices2(IEnumerable<Matrix> matrices, float degrees， 
CancellationToken token) 


// 警告 : 不 推荐 使 用 ， 原 因 见 后 面 。 


Parallel.ForEach(matrices, matrix => 





{ 
matrix.Rotate(degrees); 
token.ThrowIfCancellationRequested(); 
]); 
} 


但 是 第 二 种 方法 更 麻烦 ， 用 起 来 也 不 协调 。 使 用 第 二 种 方法 时 ， 并 行 循 环 会 把 Operation 
CanceledException 封装 进 AggregateException。 另 外 ， 如 果 把 CancellationToken 传 入 到 
parattetoptions 的 实例 中 ，parattet 类 会 做 出 更 加 智能 化 的 判断 ， 确 定 检查 标记 的 频率 。 
因此 ， 把 标记 作为 参数 传人 是 最 好 的 做 法 。 


并 行 LINQ (PLINQ) 本 身 也 支持 取消 ， 可 用 MthCcancettLation 操作 符 : 


static IEnumerable<int> MultiplyBy2(IEnumerable<int> values, 
CancellationToken cancellationToken) 
{ 
return values.AsParallel() 
.WithCancellation(cancellationToken) 
.Select(item => item * 2); 


} 


讨论 

在 并 行 处 理 中 支持 取消 ， 对 于 提高 用 户 体验 非常 重要 。 程 序 在 做 并 行 处 理 时 ， 至 少 会 在 短 
时 间 内 使 用 大 量 的 CPU。 当 CPU 使 用 率 很 高 时 ， 即 使 没有 妨碍 同一 电脑 上 的 其 他 程序 ， 
用 户 也 会 注意 到 。 因 此 建议 大 家 在 做 并 行 计算 (或 其 他 CPU 密集 型 程序 ) 时 一 定 要 支持 
取消 ， 即 使 维持 CPU 高 使 用 率 的 总 时 间 不 是 很 长 。 


















































参阅 
9.1 市 介绍 如 何 发 出 取消 请 求 。 


9.6 取消 响应 式 代 码 


问题 

需要 让 响应 式 代码 支持 取消 。 

解决 方案 

响应 式 扩 展 库 有 一 个 订阅 可 观察 事件 流 的 概念 。 要 停止 对 事件 流 的 订阅 ， 只 需 在 代码 中 释 


放 订 阅 接 口 。 一 般 情况 下 要 在 逻辑 上 停止 对 事件 流 的 订阅 ， 用 这 种 方法 就 足够 了 。 例 如 下 
量 的 代码 ， 按 一 个 按钮 后 就 订阅 鼠标 点 击 事件 流 ， 按 男 一 个 按钮 后 就 停止 订阅 : 























private IDisposable _mouseMovesSubscription; 


private void StartButton_ Click(object sender, RoutedEventArgs e) 
{ 
var mouseMoves = Observable 
.FromEventPattern<MouseEventHandler, MouseEventArgs>( 
handler => (s, a) => handler(s, a), 
handler => MouseMove += handler, 
handler => MouseMove -= handler) 
.Select(x => x.EventArgs.GetPosition(this)); 
_mouseMovesSubscription = mouseMoves.Subscribe(val => 


{ 
MousePositionLabel.Content = "(" + val.X+", "+ val.Y + ")"; 
}); 
} 


private void CancelButton Click(object sender, RoutedEventArgs e) 


{ 
if (_mouseMovesSubscription != null) 
_mouseMovesSubscription.Dispose(); 


} 





但 是 ， 在 Rx 框架 中 融合 被 广泛 使 用 的 CancellationTokenSource/CancellationToken 体系 其 
实 是 很 方便 的 。 本 市 的 其 余部 分 介绍 Rx 与 CancellationToken 交互 的 方法 。 





首先 来 看 一 个 主要 场景 ， 异步 代码 封装 了 可 观察 流 代码 。7.5 节 详 细 介 绍 了 这 种 情况 ， 现 
在 我 们 要 增加 它 对 CancellationToken 的 支持 。 一 般 来 说 最 简单 的 做 法 是 : 用 响应 式 操作 
符 实 现 所 有 操作 ， 然 后 调用 ToTask 把 最 后 一 个 作为 结果 的 元 素 转 换 成 支持 await 的 Task 
对 象 。 下 面 的 代码 展示 用 异步 方式 使 用 队列 中 的 最 后 一 个 元 素 : 
































CancellationToken cancellationToken = ... 

IObservable<int> observable = ... 

int LastELement = await observable.TakeLast(1).ToTask(cancellationToken); 
// 或 者 int lastElement = await observable.ToTask(cancellationToken); 





使 用 第 一 个 元 素 的 方法 也 类 似 ， 只 需要 在 调用 ToTask 前 改 一 下 observable: 


CancellationToken cancellationToken = ... 
IObservable<int> observable = ... 
int firstElement = await observable.Take(1).ToTask(cancellationToken); 


用 异步 方式 把 整个 observable 序列 转换 成 task 对 象 ， 也 很 类 似 : 


CancellationToken cancellationToken = ... 
IObservable<int> observable = ... 
IList<int> allElements = await observable.ToList().ToTask(cancellationToken); 


最 后 我 们 来 看 相反 的 情况 。 我 们 刚 看 了 Rx 代码 响应 CancellationToken 的 几 种 方法 ， 也 就 
是 说 ，CancellationTokenSource 的 取消 请 求 被 转化 为 一 个 停止 订阅 指令 (释放 订阅 接口 )。 
我 们 也 可 以 走 另 一 个 途径 : 把 发 出 取消 请 求 作为 对 释放 订阅 接口 的 响应 。 
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正如 7.6 节 讲 的 ， 操 作 符 FromAsync、StartAsync、SelectMany 都 支持 取消 。 在 绝 大 部 分 情 
况 下 这 已 经 够 用 了 。Rx 也 支持 CancellationDisposable 类 ， 可 以 这 样 直接 使 用 : 


Using (var cancellation = new CancellationDisposable()) 


CancellationToken token = canceLLation.Token; 


// 把 这 个 标记 传 给 会 对 它 作 出 响应 的 方法 。 





// 到 这 里 ， 这 个 标记 已 经 是 取消 的 。 


讨论 
Rx 有 它 自己 关于 取消 的 理念 ， 那 就 是 : 停止 订阅 。.NET 4.0 引入 了 通用 的 取消 框架 。 本 节 
介绍 了 几 种 让 Rx 与 这 种 通用 框架 有 机 融合 的 方法 。 如 果 革 段 代 码 中 只 用 到 了 Rx， 那 就 使 
用 Rx 的 “订阅 /停止 订阅 ”体系 。 只 有 在 边界 上 才 引 入 CanceLLationToken， 以 保持 代码 
清晰 。 
































参阅 
7.5 节 介 绍 了 把 Rx 代码 封装 成 异步 代码 (不 支持 取消 )。 
7.6 节 介 绍 了 把 异步 代码 封装 成 Rx 代码 (支持 取消 )。 





9.1 市 介绍 了 如 何 发 送 取 消 请 求 。 

9.7 取消 数据 流 网 格 

问题 

需要 让 数据 流 网 格 支 持 取 消 。 

解决 方案 

在 自己 的 代码 中 支持 取消 ， 最 好 的 方法 就 是 把 CancellationToken 传递 给 支持 取消 的 API。 


数据 流 网 格 的 每 一 个 块 都 支持 取消 ， 可 在 DatafLowBLockoptions 中 设置 。 要 让 自 定义 数据 
流 块 也 支持 取消 ， 只 需要 在 块 的 参数 中 设置 CancellationToken 属性 : 


ZI 











IPropagatorBlock<int, int> CreateMyCustomBLock( 
CancellationToken cancellationToken) 


{ 
var blockOptions = new ExecutionDataflowBlockOptions 
{ 
CancellationToken = cancellationToken 
3 





var multiplyBlock = new TransformBlock<int, int>(item => item * 2， 
blockOptions); 

var addBLock = new TransformBlock<int, int>(item => item + 2， 
blockOptions); 

var divideBlock = new TransformBlock<int, int>(item => item / 2， 
blockOptions); 


var flowCompletion = new DataflowLinkOptions 


PropagateCompletion = true 
}; 
multiplyBlock.LinkTo(addBlock, flowCompletion); 
addBlock.LinkTo(divideBlock, flowCompletion); 


return DataflowBlock.Encapsulate(multiplyBlock, divideBlock); 
1 


这 个 例子 中 网 格 的 每 一 个 块 都 使 用 了 CancellationToken。 这 并 不 是 十 分 必要 的 。 因 为 完成 
信息 也 在 块 之 间 传 递 ， 可 以 只 在 第 一 块 使 用 CancellationToken， 然 后 让 它 在 块 之 间 传 递 。 
取消 被 认为 是 一 种 特殊 形式 的 错误 信息 ， 而 错误 信息 会 在 管道 le 因此 管道 中 的 
其 他 块 也 会 产生 错误 并 结束 。 但 是 当 我 们 取消 一 个 网 格 时 ， 会 希望 每 一 个 块 同时 被 取消 。 
因此 通常 是 在 每 一 个 块 中 设置 CancellationToken。 

















讨论 
在 数据 流 网 格 中 ， 取 消 过 程 不 会 有 任何 缓冲 。 块 被 取消 后 就 会 清除 所 有 输入 数据 并 停止 接 
ee ei ei 





参阅 
9.1 节 介 绍 如 何 发 送 取消 请 求 。 
淋 出: 圭 落 
9.8 注入 取消 请 求 
问题 
某 一 个 层次 的 代码 需要 响应 取消 请 求 ， 同 时 它 本 身 也 要 向 下 一 层 代 码 发 出 取消 请 求 。 
解决 方案 
.NET 4.0 的 取消 体系 本 身 就 有 这 种 功能 ， 即 连接 的 取消 标记 。 在 创建 一 个 取消 标记 源 时 ， 


可 把 它 连接 到 一 个 (或 多 个 ) 已 有 的 标记 。 建 立 连接 后 ， 这 些 已 有 标记 中 的 任何 一 个 被 取 
消 ， 新 建 的 标记 源 中 的 标记 也 会 被 取消 。 也 可 以 显 式 地 取消 这 个 标记 源 。 

















下 面 的 代码 执行 一 个 异步 的 HTTP 请 求 。 传 入 该 方法 的 标记 代表 用 户 发 出 的 取消 请 求 ， 而 
这 个 方法 也 对 HTTP 请 求 使 用 了 一 个 超时 : 











async Task<HttpResponseMessage> GetWithTimeoutAsync(string url, 
CancellationToken cancellationToken) 


{ 


var client = new HttpClient(); 


using (var cts = CancellationTokenSource 
.CreateLinkedTokenSource(cancellationToken)) 


{ 

cts.CancelAfter(TimeSpan.FromSeconds(2)); 

var combinedToken = cts.Token; 

return await client.GetAsync(url, combinedToken); 
} 


} 


如 果 用 户 取 消 了 原 有 的 canceLLationToken， 或 者 关联 的 标记 源 被 cancelAfter 取消 ， 这 个 
创建 的 combinedToken 就 会 被 取消 。 


讨论 

例子 中 只 用 了 一 个 CancellationToken 对 象 ， 但 是 CreateLinkedTokenSource 方法 的 参数 可 
以 是 任意 多 个 取消 标记 。 我 们 可 以 用 它 来 创建 一 个 组 合 标 记 ， 实 现 具 有 某 种 逻辑 的 取消 功 
能 。 例 如 ，ASP.NET 有 一 个 表示 请 求 超时 的 标记 (HttpRequest.Timed0utToken) 和 一 个 表 
示 用 户 断 开 连 接 的 标记 (HttpResponse.ClientDisconnectedToken)。 可 以 在 代码 中 创建 一 
个 连接 的 标记 ， 对 这 些 取消 请 求 中 的 任意 一 个 做 出 响应 。 


需要 注意 已 连接 的 取消 标记 源 的 生命 周期 。 前 面 的 例子 代表 了 常见 的 情况 ， 一 个 或 多 个 取 
消 标记 传人 方法 ， 然 后 被 连接 在 一 起 并 作为 组 合 标 记 继续 传 下 去 。 注 意 例子 中 的 代码 使 用 
了 using 语句 ， 当 操作 完成 时 (不 需要 继续 使 用 组 合 标 记 了 ) 会 释放 已 连接 的 取消 标记 源 。 
假定 不 释放 已 连接 的 取消 标记 源 ， 会 发 生 什 么 情况 : 这 个 方法 可 能 被 多 次 调用 ， 每 次 使 用 
同一 个 (长 寿命 的 ) 原 有 标记 ， 这 样 每 次 都 会 连接 一 个 新 的 标记 源 。 即 使 HTTP 请 求 已 经 
结束 了 (没有 用 到 组 合 标记 )， 标 记 源 仍 会 连 在 原 有 的 标记 上 。 为 了 防止 这 种 内 存 泄漏 的 
情况 ， 一 旦 不 再 需要 组 合 标记 了 ， 就 要 释放 已 连接 的 取消 标记 源 。 









































参阅 
9.9 节 介 绍 发 送 取 消 请 求 的 常规 做 法 。 


9.3 节 介 绍 把 取消 用 作 超 时 。 








Re 4 [一 
9.9 与 其 他 取消 体系 的 互 操作 
问题 
有 一 些 外 部 的 或 以 前 遗留 下 来 的 代码 采用 了 非 标准 的 取消 模式 。 现 在 要 用 标准 的 
CancellationToken 来 控制 这 些 代码 。 
解决 方案 
CancellationToken 类 响应 取消 请 求 有 两 种 主要 的 方式 : 轮 询 ( 见 9.2 节 ) 和 回调 函数 (本 


节 的 主题 )。 轮 询 通常 用 于 计算 密集 型 代码 ， 如 数据 处 理 的 循环 。 回 调 函 数 通常 用 于 其 他 
情况 。 可 以 用 CancellationToken.Register 方法 注册 一 个 取消 标记 的 回调 函数 。 




















例如 ， 假 设 我 们 要 封装 System.Net.NetworkInformation.Ping 类 ， 并 日 要 实现 对 一 个 ping 
过 程 的 取消 。 这 个 Ping 类 已 经 有 基于 Task 的 API， 但 不 支持 CancellationToken。 但 是 
Ping 类 有 自己 的 SendAsyncCancel 方法 ， 可 以 用 来 取消 一 个 ping 过 程 。 因 此 我 们 注册 一 个 
调用 这 个 方法 的 回调 函数 ， 如 下 所 示 : 





async Task<PingRepLy> PingAsync(string hostNameOrAddress, 
CancellationToken cancellationToken) 


{ 
var ping = new Ping(); 
using (cancellationToken.Register(() => ping.SendAsyncCancel())) 


return await ping.SendpingAsync(hostNameOrAddress); 
} 
+ 
这 样 ， 在 发 出 取消 请 求 时 这 个 回调 函数 就 会 调用 SendAsyncCancel 方法 ， 来 取消 SendPing 
Async 的 执行 。 


讨论 

可 以 用 CancellationToken.Register 方法 与 任何 类 型 的 非 主 流 取消 体系 进行 互 操 作 。 但 
是 有 一 点 一 定 要 记 住 ， 当 一 个 方法 使 用 CancellationToken 后 ， 一 个 取消 请 求 应 该 只 用 
来 取消 那 一 个 操作 。 有 些 非 主 流 的 取消 体系 通过 关闭 一 些 资源 来 实现 取消 ， 而 关闭 资源 
会 取消 多 个 操作 。 此 类 取消 体系 就 不 大 适合 使 用 CancellationToken。 如 果 你 一 定 要 用 
CancellationToken 封装 此 类 取消 体系 ， 那 就 在 文档 中 把 这 个 不 寻常 的 语法 描述 清楚 吧 。 
































要 特别 注意 回调 函数 注册 的 生命 周期 。Register 方法 返回 一 个 可 释放 的 对 象 ， 应 该 在 不 再 
需要 回调 函数 时 把 它 释 放 。 前 面 的 例子 使 用 了 using 语句 ， 会 在 异步 操作 结束 时 清理 资源 。 
如 果 不 使 用 using 语句 ， 每 次 调用 这 个 例子 时 使 用 同一 个 〈 长 寿命 的 ) CanceLtationToken， 


























它 就 会 每 次 都 添加 一 个 回调 函数 (这 个 回调 函数 又 会 使 Ping 对 象 继续 存活 )。 为 了 避免 内 
存 和 资源 的 泄漏 ， 一 旦 不 再 需要 使 用 回调 函数 了 ， 就 要 释放 这 个 回调 函数 注册 。 





参阅 
9.2 节 介 绍 用 轮 询 而 不 是 用 回调 函数 来 响应 取消 标记 。 








9.1 市 介绍 用 常规 方法 发 出 取消 请 求 。 
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现代 程序 需要 异步 编程 ， 现 在 的 服务 器 程序 必须 有 更 好 的 可 扩展 性 ， 用 户 端 程序 必须 有 更 
好 的 交互 性 。 开 发 者 们 意识 到 必须 学 习 异 步 编 程 ， 他 们 在 这 个 领域 进行 探索 之 后 ， 发 现 异 
步 编 程 经 常会 与 已 经 习惯 了 的 传统 面向 对 象 编程 冲突 。 


冲突 的 主要 原因 在 于 异步 编程 是 函数 式 的 (functional)。 这 里 “functional” 的 意思 并 不 是 
“具备 功能 ， 它 是 一 种 函数 式 编 程 方 式 ， 而 不 是 过 程式 编程 方式 。 很 多 开发 人 员 在 大 学 里 
学 习 了 基本 的 函数 式 编 程 ， 后 来 却 很 少 使 用 。 如 果 像 (car (cdr '(3 5 7))) 这 样 的 代码 让 
你 有 似曾相识 的 感觉 ， 那 你 属于 这 类 人 。 但 是 不 要 害怕 ， 只 要 你 习惯 了 ,现代 的 异步 编程 
也 没 那么 难 。 









































引入 async 对 异步 开发 的 主要 突破 ， 是 在 异步 编程 时 仍然 可 以 用 过 程式 编程 的 思维 方式 思 
考 。 这 让 异步 方法 的 编写 和 理解 变 得 更 加 容易 。 但 是 在 内 部 实现 中 ， 异 步 代 码 本 质 上 仍 是 
函数 式 。 在 经 典 的 面向 对 象 设计 中 生硬 地 使 用 async 方法 ， 就 会 产生 一 些 问题 。 本 章 讲 述 
如 何 应 对 异步 代码 与 面向 对 象 编程 发 生 的 冲突 。 


在 把 已 有 的 OOP 〈 面 向 对 象 编程 ) 基础 代码 转换 成 async 风格 的 基础 代码 时 ， 这 些 冲 突 尤 
为 明显 。 


10.1 异步 接口 和 继承 


问题 
接口 或 基 类 中 有 一 个 方法 ， 现 在 希望 实现 异步 。 
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解决 方案 

理解 本 问题 和 解决 方案 的 关键 ， 是 要 知道 异步 是 一 种 具体 的 实现 方式 。 不 可 能 把 接口 方 
法 或 抽象 方法 标记 为 async。 但 是 可 以 把 一 个 方法 编写 得 跟 async 方法 一 样 ， 只 不 过 不 用 
async 这 个 关键 字 。 

要 知道 可 以 用 await 等 待 的 是 类 ， 而 不 是 方法 。 可 以 用 await 等 待 某 个 方法 返回 的 Task 


对 象 ， 不 管 它 是 不 是 async 方法 。 因 此， 一 个 接口 或 抽象 方法 可 以 返回 一 个 Task (或 
Task<T>) 对 象 ， 这 个 对 象 可 以 用 await 等 待 。 

















下 面 的 代码 定义 了 一 个 包含 异步 方法 (不 用 async) 的 接口 、 对 该 接口 的 实现 (用 async)， 
还 定义 了 一 个 独立 的 方法 ， 来 调用 该 接口 的 方法 (用 await)。 


interface IMyAsyncInterface 


‘ 

Task<int> CountBytesAsync(string url); 
} 
class MyAsyncClass : IMyAsyncInterface 


public async Task<int> CountBytesAsync(string url) 


€ 
var client = new HttpClient(); 
var bytes = await client.GetByteArrayAsync(url); 
return bytes.Length; 

} 


3 


static async Task UseMyInterfaceAsync(IMyAsyncInterface service) 


{ 
var result = await service.CountBytesAsync("http://www.example.com"); 
Trace.WriteLine(result); 


} 
这 种 模式 也 适用 于 基 类 中 的 抽象 方法 。 

















异步 方法 的 特征 仅仅 表示 它 的 实现 可 以 是 异步 的 。 如 果 没 有 真正 的 异步 任务 ， 用 同步 方式 
实现 这 个 方法 也 是 可 以 的 。 例 如 ， 在 测试 存根 的 代码 中 可 以 用 FromResult 来 实现 前 面 的 接 
口 (不 用 async) : 





class MyAsyncClassStub : IMyAsyncInterface 


{ 
public Task<int> CountBytesAsync(string url) 
€ 
return Task.FromResult(13); 
} 
} 





讨论 


在 编写 本 书 时 (2014)，async 和 await 推出 还 没 多 久 。 随 着 异步 方法 越 来 越 普遍 ， 在 接口 
和 基 类 上 实现 的 异步 方法 也 会 越 来 越 多 。 这 其 实 并 不 难 ， 只 要 记 住 两 点 ， 可 以 用 await 等 
待 的 是 返回 的 类 (而 不 是 方法 ) ; 对 一 个 异步 方法 的 定义 ， 可 以 用 异步 方式 实现 ， 也 可 以 





用 同步 方式 实现 。 


参阅 





2.2 市 介绍 用 同步 代码 实现 一 个 具有 异步 特征 的 方法 ， 并 返回 一 个 已 完成 的 Task 对 象 。 


10.2 异步 构造 : 工厂 
问题 
需要 在 一 个 类 的 构造 函数 里 进行 异步 操作 。 


解决 方案 


构造 函数 是 不 能 异步 的 ， 也 不 能 使 用 await 关键 字 。 假 如 能 用 await 等 待 一 个 构造 函数 ， 
当然 能 解决 问题 ， 但 那 需要 对 C# 语言 进行 很 大 的 改动 。 


一 种 可 能 是 将 构造 函数 与 一 个 异步 的 初始 化 方法 配对 使 用 ， 就 像 下 面 这 样 使 用 类 : 


var instance = new MyAsyncClass(); 
await instance.InitializeAsync(); 














但 是 这 种 做 法 有 缺点 。 很 容易 忘记 调用 InitializeAsync 方法 ， 并 且 类 的 实例 在 构造 完 后 


不 能 马上 使 用 。 





更 好 的 解决 方案 ， 是 为 这 个 类 建立 自己 的 工 





CLass MyAsyncCLass 


private MyAsyncClass() 








o 下 画 








i 展示 了 异步 工厂 方法 的 模式 : 





{ 
} 
private async Task<MyAsyncClass> InitializeAsync() 
{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
return this; 
} 


public static Task<MyAsyncCLass> CreateAsync() 
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{ 
var result = new MyAsyncClass(); 
return result.InitializeAsync(); 
3 
} 


构造 函数 和 InitializeAsync 是 private， 因 此 其 他 代码 不 可 能 误 用 。 创 建 实例 的 唯一 方法 
是 使 用 静态 的 CreateAsyncfactory 方法 ， 并 且 在 初始 化 完成 前 ， 调 用 者 是 不 能 访问 这 个 实 
例 的 。 


其 他 代码 可 以 这 样 创建 一 个 实例 : 











var instance = await MyAsyncClass.CreateAsync(); 


讨论 

这 种 模式 的 主要 好 处 是 ， 其 他 代码 无 法 访问 尚未 初始 化 的 MyAsyncClass 实例 。 因 此 我 建议 
大 家 尽 可 能 采用 这 种 模式 ， 而 不 是 其 他 方法 。 
可 惜 在 有 些 情况 下 ， 这 种 方法 无 法 使 用 ， 特 别 是 当代 码 用 到 了 依赖 注入 提供 者 的 时 候 。 在 
编写 本 书 时 (2014)， 主 要 的 依赖 注入 或 控制 反 转 库 都 不 能 与 异步 代码 一 起 使 用 。 这 种 情 
况 下 ， 我 们 还 有 几 个 解决 办 法 。 






































如 果 创 建 的 实例 是 一 个 共享 资源 ， 那 可 以 使 用 异步 的 Lazy 类 型 ( 见 13.1 节 )。 否 则 ， 可 以 
使 用 10.3 节 介 绍 的 异步 初始 化 模式 。 


请 大 家 不 要 使 用 这 样 的 代码 : 


class MyAsyncClass 


{ 
public MyAsyncClass() 
€ 
InitializeAsync(); 
} 
// 坏 代码 !! 
private async void InitializeAsync() 
{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
} 
} 














这 种 做 法 初 看 起 来 好 像 很 有 道理 :用 一 个 常规 的 构造 函数 启动 一 个 异步 操作 。 但 这 样 使 用 
async void 有 儿 个 缺点 。 第 一 个 问题 ， 当 构造 函数 结束 时 ， 初 始 化 过 程 仍 在 异步 地 进行 ， 
并 且 没 有 直观 的 方法 可 以 监测 异步 的 初始 化 过 程 是 否 已 完成 。 第 二 个 问题 与 错误 处 理 有 
关 : InitializeAsync 方法 引发 的 任何 错误 ， 相 关 的 catch 语句 都 无 法 捕获 。 














参 [ 


Eg 


i 


10.3 节 介 绍 异 步 初始 化 模式 ， 针 对 使 用 了 依赖 注入 /控制 反 转 容器 的 情况 ， 实 现 异步 构造 。 





13.1 市 介绍 如 何 异步 地 初始 化 Lazy 对 象 。 如 果实 例 在 概念 上 是 共享 的 资源 或 服务 ， 这 是 
一 种 可 行 的 解决 方案 。 


10.3 异步 构造 : 异步 初始 化 模式 


问题 
一 个 类 的 构造 函数 需要 执行 异步 过 程 ， 但 是 不 能 使 用 异步 工厂 模式 ( 见 10.2 节 )， 因 


为 这 个 类 的 实例 是 通过 反射 (如 依赖 注入 /控制 反 转 容器 、 数 据 绑 定 、Activator， 
CreateInstance 等 ) 创建 的 。 


解决 方案 
这 种 情况 下 必须 返回 一 个 未 初始 化 的 实例 ， 但 可 以 使 用 一 种 通用 模式 来 减少 不 利 因素 : 异 
步 初始 化 模式 。 对 于 每 个 需要 异步 初始 化 的 类 ， 都 要 定义 一 个 属性 ; 

















Task Initialization { get; } 


我 一 般 为 需要 异步 初始 化 的 类 建 一 个 标识 接口 (maker interface) ， 在 标识 接口 内 定义 这 个 
属性 : 


/// <summary> 

/// 把 一 个 类 标记 为 “需要 异步 初始 化 ” 
/// 并 提供 初始 化 的 结果 。 

/// </summary> 

public interface IAsyncInitialization 

















{ 
/// <summary> 
/// 本 实例 的 异步 初始 化 的 结果 。 
/// </summary> 
Task Initialization { get; } 
} 


实现 了 这 种 模式 后 ， 就 要 在 构造 函数 内 启动 初始 化 (并 分 配 这 个 Initialization 属性 )。 
异步 初始 化 的 结果 (包括 所 有 的 异常 ) 是 通过 Initialization 属性 对 外 公开 的 。 下 面 的 例 
子 实现 了 一 个 使 用 异步 初始 化 的 类 : 











class MyFundamentalType : IMyFundamentalType, IAsyncInitialization 


public MyFundamentalType() 
{ 
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Initialization = InitializeAsync(); 


} 
public Task Initialization { get; private set; } 


private async Task InitializeAsync() 


{ 

// 对 这 个 实例 进行 异步 初始 化 。 

await Task.Delay(TimeSpan.FromSeconds(1)); 
} 


3 
如 果 使 用 了 依赖 注入 /控制 反 转 库 ， 可 以 用 下 面 的 方式 创建 和 初始 化 一 个 类 的 实例 : 


IMyFundamentaLType instance = UltimateDIFactory.Create<IMyFundamentalType>(); 
var instanceAsyncInit = instance as IAsyncInitialization; 
if (instanceAsyncInit != null) 

await instanceAsyncInit.Initialization; 





可 以 对 这 种 模式 进行 扩展 ， 将 类 和 异步 初始 化 结合 起 来 。 下 面 的 例子 定义 了 另 一 个 类 ， 它 
以 前 面 建立 的 IMyFundamentalType 为 基础 ; 

















class MyComposedType : IMyComposedType, IAsyncInitialization 





{ 
private readonly IMyFundamentalType _fundamental; 
public MyComposedType(IMyFundamentaLType fundamental) 
€ 
_fundamental = fundamental; 
Initialization = InitializeAsync(); 
} 
public Task Initialization { get; private set; } 
private async Task InitializeAsync() 
{ 
// 如 有 必要 ， 异 步 地 等 待 基 础 实例 的 初始 化 。 
var fundamentalAsyncInit = _fundamental as IAsyncInitialization; 
if (fundamentalAsyncInit != null) 
await fundamentalAsyncInit.Initialization; 
// 做 自己 的 初始 化 工作 (同步 或 异步 )。 
} 
} 


这 个 混合 类 在 进行 它 自 己 的 初始 化 之 前 ， 先 等 待 它 的 所 有 部 件 都 初始 化 完毕 。 需 要 遵循 一 
个 规则 ， 即 在 InitializeAsync 结束 前 ， 每 个 部 件 都 必须 初始 化 完毕 。 只 要 混合 类 的 初始 
化 过 程 完成 了 ， 就 能 保证 它 所 依赖 的 每 个 类 型 也 是 经 过 初始 化 的 。 部 件 的 初始 化 过 程 中 产 
生 的 任何 异常 ， 会 传递 给 混合 类 的 初始 化 过 程 。 




















讨论 

建议 大 家 尽量 不 要 使 用 这 个 解决 方案 ， 而 是 使 用 异步 工厂 〈 见 10.2 市 ) 或 异步 Lazy 对 象 
初始 化 〈 见 13.1 节 )。 那 些 才 是 最 好 的 方法 ， 因 为 它们 绝 不 可 能 暴露 未 初始 化 的 实例 。 但 
是 ， 如 果 用 注入 依赖 /控制 反 转 、 数 据 绑 定 方式 等 创建 实例 ， 那 就 不 可 避免 地 要 暴露 未 初 
始 化 的 实例 。 这 种 情况 下 ， 就 推荐 使 用 本 市 讲述 的 异步 初始 化 模式 .。 





从 异步 接口 ( 见 10.1 节 ) 开始 我 们 就 讲 过 ， 异 步 方 法 的 特征 仅仅 表示 这 个 方法 可 以 是 异步 
的 。 前 面 的 MyComposedType.InitializeAsync 代码 正好 说 明 这 点 : 如 果 IMyFundamentalType 
实例 也 没有 实现 IAsyncInitialization， 并 且 MyComposedType 没有 用 异步 方式 对 自己 进行 
初始 化 ， 那 么 它 的 InitializeAsync 方法 实际 上 会 同步 地 完成 。 

















检查 某 个 实例 是 否 实现 了 IAsyncInitialization， 并 对 它 做 初始 化 ， 这 个 过 程 的 代码 非常 
腔 肿 ， 尤 其 是 这 个 组 合 类 有 很 多 部 件 的 情况 。 有 一 个 很 容易 的 办 法 可 以 简化 代码 ， 就 是 创 
建 一 个 辅助 方法 : 








public static class AsyncInitialization 


{ 
static Task WhenAllInitializedAsync(params object[] instances) 
{ 
return Task.WhenAll(instances 
.OfType<IAsyncInitialization>() 
.Select(x => x.Initialization)); 
} 
} 


可 以 调用 InitiatizeallAsync 并 传 入 需要 初始 化 的 任何 实例 。 这 个 方法 会 忽略 那些 未 实现 
IAsyncInitialization 的 实例 。 如 果 一 个 组 合 类 依赖 了 三 个 注入 的 实例 ， 它 的 初始 化 代码 
就 可 以 这 么 写 : 

private async Task InitializeAsync() 


// 异步 地 等 待 三 个 实例 全 部 初始 化 完毕 (有 些 可 能 不 需要 初始 化 )。 
await AsyncInitialization.WhenAllInitializedAsync(_fundamental, 
_anotherType, _yetAnother); 


// 做 自己 的 初始 化 工作 (同步 或 异步 )。 





10.2 节 介 绍 了 异步 工厂 ， 用 它 可 以 异步 地 构造 实例 ， 而 不 会 公开 未 初始 化 的 实例 。 
13.1 节 介 绍 异 步 地 初试 化 Lazy 对 象 ， 用 于 实例 为 共享 资源 或 服务 的 情况 。 
10.1 节 介 绍 异 步 接口 。 
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10.4 异步 属性 


问题 
要 把 一 个 属性 改 成 异步 方式 。 该 属性 不 会 用 于 数据 绑 定 。 


解决 方案 

在 使 用 async 改造 原 有 代码 时 ， 经 常会 出 现 这 样 的 问题 。 这 时 你 会 在 属性 的 get 方法 中 调用 
一 个 异步 方法 。 但 实际 上 根本 没有 “异步 属性 ”这 种 东西 。 不 允许 在 属性 中 使 用 async 关键 
字 ， 这 么 规定 是 有 好 处 的 。 属 性 的 get 方法 应 该 返回 当前 值 ， 不 应 该 启动 一 个 后 台 的 操作 : 

















// 我 们 假想 的 代码 (请 不 要 编译 )。 
public int Data 


{ 
async get 
€ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
return 13; 
} 
} 


当 你 发 现 需要 在 代码 中 加 入 一 个 “异步 属性 ”时 ， 实 际 上 应 该 选用 其 他 方案 。 选 用 哪 种 解 
决 方案 取决 于 要 对 属性 值 计算 一 次 还 是 多 次 。 需 要 确定 是 下 面 两 种 情况 中 的 哪 一 种 : 

















。 每 次 读 取 属性 时 ， 都 要 对 值 进行 异步 计算 ， 

。 异步 地 计算 属性 值 一 次 ， 并 缓存 起 来 供 以 后 访问 。 

如 果 每 次 读 取 “异步 属性 ”时 都 要 启动 一 次 新 的 (异步 的 ) 计算 过 程 ， 那 说 明 它 不 是 一 个 属 
性 。 它 实际 上 是 一 个 经 过 伪装 的 方法 。 如 果 你 在 把 同步 代码 转换 成 异步 代码 的 时 候 遇 到 这 种 
情况 ， 那 就 要 意识 到 原始 的 设计 就 是 错误 的 。 实 际 上 这 个 属性 从 一 开始 就 应 该 是 一 个 方法 ， 








// 作为 一 个 异步 方法 。 
public async Task<int> GetDataAsync() 


{ 


await Task.Delay(TimeSpan.FromSeconds(1)); 
return 13; 


} 
属性 也 可 以 直接 返回 一 个 Task<int>， 例 如 : 








// 作为 一 个 返回 Task 的 属性 。 
// 这 个 API 设计 是 有 问题 的 。 
public Task<int> Data 


{ 
get { return GetDataAsync(); } 

















private async Task<int> GetDataAsync() 


{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
return 13; 


} 


但 是 我 建议 大 家 不 要 采用 这 种 做 法 。 如 果 每 次 访问 属性 都 会 启动 一 次 新 的 异步 操作 ， 那 说 明 
这 个 “属性 ”其 实 应 该 是 一 个 方法 。 当 它 是 异步 的 方法 ， 人 们 就 会 更 清楚 地 知道 每 次 访问 都 
会 开始 新 的 异步 操作 ， 因 此 这 个 API 就 不 会 误导 别人 。10.3 节 和 10.6 节 中 确实 有 返回 Task 
的 属性 ， 但 它们 是 作为 一 个 整体 被 实例 使 用 的 。 每 次 读 取 它 们 时 不 会 启动 新 的 异步 操作 。 


前 面 的 解决 方案 用 于 每 次 访问 都 会 计算 属性 值 的 情况 。 另 一 种 情况 是 “异步 属性 ”只 局 动 
一 次 (异步) 计算 ， 并 缓存 计算 结果 供 以 后 使 用 。 针 对 这 种 情况 ， 可 以 使 用 异步 的 Lazy 
对 象 初始 化 。 这 方面 将 在 13.1 节 详 述 ， 现 在 先 来 看 一 下 代码 : 

// 作为 一 个 缓存 的 数据 。 


public AsyncLazy<int> Data 


{ 


get { return _data; } 
































private readonly AsyncLazy<int> _data = 
new AsyncLazy<int>(async () => 


{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
return 13; 
半生 
这 段 代码 只 会 异步 地 计算 一 次 ， 然 后 每 次 向 调用 者 返回 同一 个 值 。 调 用 的 代码 如 下 : 


int value = await instance.Data; 


这 时 ， 计 算 过 程 只 会 发 生 一 次 ， 因 此 使 用 属性 是 合适 的 。 


讨论 

有 一 个 重要 的 问题 需要 明确 : 读 取 属性 时 是 否 要 启动 一 个 新 的 异步 操作 。 如 果 管 案 为 
“是 ”， 那 就 不 要 用 属性 ， 改 用 异步 方法 。 如 果 属 性 要 充当 一 个 惰性 求 值 (lazy-evaluated) 
的 缓存 ， 那 就 使 用 异步 初始 化 〈 见 13.1 节 )。13.3 节 会 介绍 用 于 数据 绑 定 的 属性 。 


在 把 同步 属性 转换 为 “异步 属性 ”时 ， 不 能 这 么 做 : 























private async Task<int> GetDataAsync() 

{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
return 13; 
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public int Data 


// 坏 代码 ! ! 
get { return GetDataAsync().Result; } 
} 


不 要 用 Result 或 Wait 把 异步 代码 强制 转换 为 同步 代码 。 在 GUI 和 ASP.NET 平 台中， 这 
样 的 代码 很 容易 造成 死 锁 。 即 使 绕 过 了 死 锁 ， 这 也 是 一 个 容易 引起 误解 的 API: 一 个 属性 
的 get 方法 〈 它 本 该 是 一 个 快速 、 同 步 的 操作 ) 其 实 是 一 个 阻塞 的 操作 。 关 于 这 种 阻塞 问 
题 ， 第 1 章 有 更 详细 的 描述 。 

















既然 我 们 在 讨论 异步 代码 中 的 属性 ， 那 就 有 必要 考虑 一 下 状态 与 异步 代码 的 关系 。 在 把 
同步 的 基础 代码 转换 成 异步 代码 时 ， 这 一 点 尤为 重要 。 看 一 下 API 对 外 提供 的 每 个 状态 
(例如 通过 属性 提供 )。 思 考 一 个 问题 ， 在 异步 操作 进行 的 过 程 中 ， 该 对 象 的 当前 状态 是 什 
么 ?这 个 问题 没有 正确 的 答案 ,但 要 考虑 清楚 你 想 要 表达 的 语义 ， 并 把 它 写 进 文 档 ， 这 一 
点 很 重要 。 








举 个 例子 ， 来 看 Stream.Position， 它 表示 一 个 流 的 指针 当前 偏 移 位 置 。 使 用 同步 API 的 
情况 ， 当 调用 Stream.Read 或 Stream.Write 时 ， 它 就 完成 了 实际 的 读 / 写 功能 ， 并 且 在 
Read 或 Write 返回 前 更 新 Stream.Position 的 位 置 。 这 些 同步 代码 的 语义 是 非常 明确 的 。 








现在 来 考虑 Stream.ReadAsync 和 Stream.WriteAsync 的 情况 : 什么 时 候 修 改 Stream. 
Position ? 在 读 / 写 操作 结束 时 ， 还 是 在 真正 开始 读 / 写 之 前 ? 如 果 是 在 结束 前 修改 ， 那 
是 在 ReadAsync/WriteAsync 返回 时 同步 地 修改 ， 还 是 在 返回 后 立即 修改 ? 








这 个 例子 很 好 地 说 明了 : 对 于 同步 代码 来 说 ， 对 外 提供 状态 的 属性 其 语义 是 非常 明确 的 ， 
但 对 于 异步 代码 就 没有 明显 正确 的 语义 了 。 当 然 事情 没 那么 可 怕 : 在 把 类 改 成 异步 方式 
时 ， 只 需要 对 整个 API 进行 全 局 考虑 ， 并 把 选 定 的 语义 在 文档 中 描述 清楚 。 

参阅 

13.1 市 详细 介绍 了 异步 Lazy 对 象 初始 化 。 

13.3 节 介 绍 了 需要 支持 数据 绑 定 的 “异步 属性 ”。 


10.5 ”异步 事件 
问题 


需要 一 个 可 以 异步 运行 的 事件 处 理 器 ， 并 且 需 要 监测 事件 处 理 器 是 否 已 经 完成 。 注 意 这 种 
情况 非常 少见 。 一 般 来 说 ， 提 出 一 个 事件 后 就 不 再 关心 事件 处 理 器 何 时 完成 。 
































解决 方案 

监测 async void 类 型 的 事件 处 理 器 什么 时 候 返 回 是 根本 不 可 行 的 ， 因 此 需要 采用 其 他 办 
法 。Windows 应 用 商店 平台 引入 了 一 个 名 为 延期 (deferral) 的 概念 ， 可 用 来 跟踪 异步 事件 
处 理 器 。 异 步 事件 处 理 器 在 第 一 次 使 用 await 前 分 配 一 个 延期 对 象 ， 处 理 结束 时 通知 这 个 
延期 对 象 。 同 步 的 事件 处 理 器 不 需要 使 用 延期 。 


Nito.AsyncEx 库 中 有 一 个 DeferralManager 类 (延期 管理 器 )， 引 发 事件 的 组 件 可 使 用 它 。 
事件 处 理 器 可 以 利用 这 个 延期 管理 器 来 分 配 延 期 对 象 ， 并 且 跟 踪 每 个 延期 对 象 的 完成 时 间 。 






























































对 每 个 需要 等 待 处 理 完毕 的 事件 ， 首 先 要 扩展 事件 参数 类 : 


public class MyEventArgs : EventArgs 





{ 
private readonly DeferralManager _deferrals = new DeferralManager(); 
.… // 自身 的 构造 函数 和 属性 。 
public IDisposable GetDeferral() 
{ 
return _deferrals.GetDeferral(); 
} 
internal Task WaitForDeferralsAsync() 
{ 
return _deferrals.SignalAndWaitAsync(); 
} 
} 























在 编写 异步 事件 处 理 器 时 ， 事 件 参数 类 最 好 是 线程 安全 的 。 要 做 到 这 点 ， 最 简单 的 办 法 就 
是 让 它 成 为 不 可 变 的 〈 即 把 所 有 的 属性 都 设 为 只 读 )。 


接着 ， 就 可 以 在 每 次 引发 事件 后 (异步 地 ) 等 待 ， 直 到 所 有 蜡 步 事 件 处 理 器 完成 。 如 果 没 
有 事件 处 理 器 ， 下 面 的 代码 会 返回 一 个 已 完成 的 Task 对 象 ， 否 则 会 创建 一 个 事件 参数 类 的 
新 实例 ， 并 传 入 事件 处 理 器 ， 然 后 等 待 任意 异步 事件 处 理 器 的 完成 : 
































public event EventHandler<MyEventArgs> MyEvent; 


private Task RaiseMyEventAsync() 
{ 
var handler = MyEvent; 
if (handler == nuLL) 
return Task.FromResult(0); 


var args = new MyEventArgs(...); 
handler(this, args); 
return args.WaitForDeferralsAsync(); 
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然后 异步 事件 处 理 器 可 以 在 using 块 中 使 用 延期 对 象 ， 该 延期 对 象 会 在 被 销毁 时 通知 延期 
管理 器 : 








async void AsyncHandler(object sender, MyEventArgs args) 


{ 
using (args.GetDeferral()) 


await Task.Delay(TimeSpan.FromSeconds(2)); 
} 
} 


这 种 方式 与 Windows 应 用 商店 平台 的 延期 对 象 有 细微 的 差别 。 在 Windows 应 用 商店 API 
中 ， 每 个 需要 延期 对 象 的 事件 定义 自己 的 延期 类 。 而 且 这 个 延期 类 有 一 个 显 式 定义 的 
Complete 方法 ， 而 不 是 IDisposable。 


讨论 

.NET 中 的 事件 在 逻辑 上 可 以 分 为 两 类 ， 它 们 之 间 的 语义 差别 很 大 。 为 了 区 分 ， 我 称 它们 
为 通知 事件 和 命令 事件 。 这 不 是 官方 的 术语 ， 仅 仅 是 我 为 了 便于 区 分 而 选用 的 名 词 。 引 发 
一 个 通知 事件 是 为 了 把 一 些 情 况 通知 给 其 他 部 件 。 通 知 完全 是 单 向 的 ， 事 件 的 发 送 者 并 不 
关心 有 没有 事件 的 接收 者 。 处 理 通 知 时 ， 发 送 者 和 接收 者 可 以 是 彻底 分 离 的 。 大 部 分 事件 
属于 通知 事件 ， 例 如 鼠标 点 击 事件 。 


相反 ， 引 发 一 个 命令 事件 是 因为 发 送 销 息 的 部 件 想 要 实现 一 些 功 能 。 虽 然 经 常 把 命令 事件 
作为 .NET 事件 处 理 ， 但 命令 事件 其 实 并 不 是 “事件 ”， 它 不 符合 “事件 ”这 个 词 的 本 意 。 
命令 发 送 者 在 继续 运行 之 前 ， 必 须 等 待 接收 者 处 理 完 事件 。 用 来 实现 访问 者 模式 (Visitor 
pattern) 的 事件 ， 这 就 是 命令 事件 。 生 命 周期 事件 也 是 命令 事件 ， 因 此 ASP.NET 页 面 的 生 
命 周期 事件 和 Windows 应 用 商店 事件 〈 例 如 AppLication.Suspenditng) 都 属于 这 类 。 本 质 
上 是 一 个 实现 过 程 的 事件 ， 也 都 是 命令 事件 〈 例 如 Backgroundworker .Dowork ) 。 





































































































通知 事件 并 不 需要 任何 特殊 代码 就 可 以 使 用 异步 的 事件 处 理 器 。 事 件 处 理 器 可 以 是 async 
void 类 型 的 ， 运 行 起 来 不 会 有 任何 问题 。 当 事件 发 送 者 引发 某 个 事件 ， 异 步 的 事件 处 理 器 
` 会 立即 完成 。 但 是 这 并 不 影响 什么 ， 因 为 它们 只 是 通知 事件 。 对 于 通知 事件 ， 为 了 文 持 
异步 的 事件 处 理 器 一 共 需 要 做 多 少 工作 ?答案 是 : 什么 也 不 用 做 。 


命令 事件 的 情况 就 不 同 了 。 对 于 命令 事件 ， 就 必须 有 一 种 方法 来 监测 事件 处 理 器 何 时 完 
成 。 前 面 使 用 延期 对 象 的 解决 方案 ， 只 适用 于 命令 事件 。 



































DeferralManager 类 在 NuGet 包 Nito.AsyncEx 中 。 











第 2 章 介绍 了 异步 编程 的 基础 知识 。 

10.6 异步 销毁 

问题 

已 经 有 了 一 个 可 以 进行 异步 操作 的 类 ， 现 在 需要 能 够 释放 它 的 资源 。 
解决 方案 


在 销毁 一 个 实例 时 ， 有 几 种 方法 来 处 理 正 在 执行 的 操作 : 可 以 把 销毁 看 做 是 一 个 针对 所 有 
正在 运行 的 操作 的 取消 请 求 ， 或 者 实现 一 个 真正 的 异步 完成 。 








把 销毁 看 成 一 个 取消 请 求 是 Windows 平台 上 的 惯例 。 文 件 流 和 套 接 字 在 关闭 时 ， 会 
取消 所 有 运行 中 的 读 / 写 过 程 。 在 .NET 环境 下 也 可 采用 类 似 的 做 法 ， 定 义 一 个 私有 
的 CancellationTokenSource 对 象 ， 并 把 取消 标记 传递 给 内 部 的 操作 。 用 下 面 的 代码 ， 
Dispose 会 取消 这 些 操作 ， 但 不 会 等 待 操作 的 完成 : 








class MyClass : IDisposable 


private readonly CancellationTokenSource _disposeCts = 
new CancellationTokenSource(); 


public async Task<int> CalculateValueAsync() 


{ 


await Task.Delay(TimeSpan.FromSeconds(2), _disposeCts.Token); 
return 13; 


} 
public void Dispose() 


_disposeCts.Cancel(); 


} 
} 


前 面 的 代码 展示 了 有 关 Dispose 的 基本 模式 。 在 实际 开发 中 应 该 增加 一 项 检查 ， 以 确认 对 
象 还 没有 被 销毁 ， 还 要 支持 方法 本 身 的 CancellationToken (使 用 9.8 节 的 技术 ) : 


public async Task<int> CalculateValueAsync(CancellationToken cancellationToken) 


{ 
using (var combinedCts = CancellationTokenSource 
.CreateLinkedTokenSource(cancellationToken, _disposeCts.Token)) 
await Task.Delay(TimeSpan.FromSeconds(2), combinedCts.Token); 
return 13; 
J 
} 
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当 Dispose 被 调用 时 ， 调 用 程序 中 所 有 运行 中 的 操作 都 会 被 取消 : 


async Task Test() 
攻 


Task<int> task; 
using (var resource = new MyClass()) 


{ 
} 


task = CalculateValueAsync(); 


// 抛 出 异常 0perationCanceLedException 
var result = await task; 


3 


在 Dispose 的 实现 中 生成 一 个 取消 请 求 ， 这 种 方法 对 于 有 些 类 运行 得 很 好 (例如 Http- 
Client 就 有 这 种 语法 )。 但 是 其 他 一 些 类 需要 知道 操作 完成 的 时 间 。 对 这 些 类 就 需要 采用 
实现 “异步 完成 ”的 方式 了 。 





异步 完成 与 异步 初始 化 ( 见 10.3 节 ) 很 相似 : 它们 都 很 少 有 官方 的 指引 资料 。 因 此 本 书 介 
绍 一 种 可 行 的 模式 ， 它 基于 TPL 数据 流 块 的 运行 方式 。 异 步 完 成 的 重要 部 分 可 以 封装 在 一 
个 接口 中 : 


/// <summary> 

/// 表明 一 个 类 需要 异步 完成 ， 并 提供 完成 的 结 

/// </summary> 

interface IAsyncCompletion 

{ 
/// <summary> 
/// 开始 本 实例 的 完成 过 程 。 概 念 上 类 似 于 “IDisposable.Dispose”。 
/// 在 调用 本 方法 后 ， 就 不 能 调用 除了 “Completion” 以 外 的 任何 成 员 。 
/// </summary> 
void Complete(); 





/// <summary> 


/// 取得 本 实例 完成 的 结 
/// </summary> 
Task Completion { get; } 


} 
实现 的 类 可 用 如 下 代码 : 


class MyClass : IAsyncCompletion 
{ 
private readonly TaskCompletionSource<object> _completion = 
new TaskCompletionSource<object>(); 
private Task _completing; 


public Task Completion 
{ 


get { return _completion.Task; } 
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public void CompLete() 


{ 


} 


if (_completing != null) 
return; 
_completing = CompleteAsync(); 


private async Task CompleteAsync() 


{ 


} 


try 
{ 


J 


catch (Exception ex) 


{ 
} 
finally 
{ 


} 





.… // 异步 地 等 待 任何 运 行 中 的 操作 。 


_completion.TrySetException(ex); 


_completion.TrySetResult(null); 


调用 它 的 代码 看 起 来 不 那么 漂亮 ，Dispose 必须 是 异步 的 ， 因 此 不 能 使 用 using 语句 。 但 
是 我 们 可 以 定义 一 对 辅助 方法 ， 完 成 类 似 using 语句 的 功能 : 


static class AsyncHeLpers 


{ 


public static async Task Using<TResource>(Func<TResource> construct, 


{ 


Func<TResouyrce, Task> process) where TResource : IAsyncCompletion 


// 创建 需要 使 用 的 资源 。 


var resource = construct(); 





// 使 用 资源 ， 并 捕获 所 有 异常 。 


Exception exception = null; 








try 
{ 
await process(resource); 
} 
catch (Exception ex) 
{ 
exception = ex; 
} 


// 完成 (逻辑 上 销毁 ) 资源 。 
resource.Complete(); 
await resource.Completion; 


// 如 果 需 要 ， 就 重新 抛 出 “process” 产 生 的 异常 。 
if (exception != null) 
ExceptionDispatchInfo.Capture(exception).Throw(); 
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} 


} 


public static async Task<TResuLt> Using<TResource, TResult>( 
Func<TResource> construct, Func<TResource, 
Task<TResult>> process) where TResource : IAsyncCompletion 


// 创建 需要 使 用 的 资源 。 


var resource = construct(); 

















// 使 用 资源 ， 并 捕获 所 有 异常 。 
Exception exception = null; 
TResult result = default(TResult); 
try 

{ 


} 


catch (Exception ex) 


{ 
} 
// 完成 (逻辑 上 销毁 ) 资源 。 


resource.Complete(); 
try 


€ 
} 


catch 


{ 


result = await process(resource); 


exception = ex; 


await resource.Completion; 





// 只 有 当 “process” 没 有 抛 出 异常 时 ， 才 允许 抛 出 “Completion” 的 异常 。 
if (exception == null) 
throw; 











} 
// 如 果 需 要 ， 就 重新 抛 出 “process” 产 生 的 异常 。 
if (exception != null) 


ExceptionDispatchInfo.Capture(exception).Throw(); 


return result; 


代码 中 使 用 了 ExceptionDispatchInfo， 以 保留 异常 的 栈 轨 迹 。 准 备 好 这 些 辅 助 方法 后 ， 调 
用 的 代码 就 可 以 这 样 使 用 using 方法 了 : 





async Task Test() 





‘ 
await AsyncHelpers.Using(() => new MyClass(), async resource => 
// 使 用 资源 。 
]); 
} 
后 二 


讨论 

跟 用 Dispose 实现 取消 请 求 的 方式 相 比 ， 异 步 完 成 的 方式 显然 要 麻烦 得 多 ， 只 有 在 确实 需 
要 时 才能 使 用 这 种 方法 。 其 实在 大 多 数 情 况 下 是 不 需要 销毁 任何 东西 的 ， 这 当然 是 最 简单 
的 方法 ， 因 为 什么 都 不 需要 做 。 














本 节 介 绍 的 异步 完成 模式 ， 用 在 TPL 数据 流 块 和 少数 其 他 类 中 (例如 ConcurrentExc 
LusiveSchedutLerPair)。 数 据 流 块 还 有 一 种 完成 请 求 类 型 ， 表 示 它 在 结束 时 会 产生 错误 
(IDataflowBlock.Fault(Exception))。 在 自 定义 的 类 中 也 可 以 使 用 这 种 模式 ， 因 此 可 把 本 
节 中 的 IAsyncCompletion 作为 一 个 如 何 实现 异步 完成 的 例子 。 











本 节 介 绍 了 两 种 处 理 销毁 过 程 的 模式 ， 这 两 种 模式 也 可 以 同时 使 用 。 一 个 类 同时 使 用 这 两 
种 模式 后 ， 当 客户 端 代码 使 用 Complete 和 Completion， 这 个 类 就 会 正常 地 关闭 ， 当 客户 端 
代码 使 用 Dispose， 这 个 类 就 会 “取消 ”操作 。 





参阅 

10.3 市 介 绍 异步 初始 化 模式 .。 

MSDN 中 关于 TPL 数据 流 的 文档 ， 介 绍 数 据 流 块 的 完成 和 正常 关闭 。 
9.8 节 介 绍 互相 连接 的 取消 标记 。 


10.1 市 介绍 异步 接口 。 
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如 果 程 序 用 到 了 并 发 技术 (几乎 所 有 .NET 程序 都 用 了 ) ， 那 就 要 特别 留意 这 种 情况 : 一 段 
代码 需要 修改 数据 ， 同 时 其 他 代码 需要 访问 同一 个 数据 。 这 种 情况 出 现时 ， 就 需要 同步 地 
访问 数据 。 本 章 的 各 小 节 介 绍 了 用 于 同步 访问 的 最 常用 的 类 。 其 实 从 本 书 中 的 其 他 章节 中 
可 以 看 出 ， 一 些 程序 库 本 身 就 已 经 做 了 很 多 更 普遍 的 同步 工作 。 在 详细 介绍 同步 技术 分 类 
之 前 ， 我 们 先 来 仔细 地 看 一 下 一 些 常见 的 、 需 要 使 用 或 不 需要 使 用 同步 的 情况 。 





本 段 内 容 对 同步 的 解释 做 了 一 定 的 简化 ， 但 是 这 些 结论 都 是 正确 的 。 








同步 的 类 型 主要 有 两 种 : 通信 和 数据 保护 。 当 一 段 代码 把 某 些 情况 (例如 收 到 新 消息 ) 通 
知 给 另 一 段 代 码 时 ， 就 得 用 到 通信 。 在 后 面 的 有 关 案 例 中 会 详细 讲述 通信 。 本 章 的 概述 部 
分 主要 讨论 数据 保护 。 


如 果 下 面 三 个 条 件 者 满足， 就 需要 用 同步 来 保护 共享 的 数据 。 


。 多 段 代码 正在 并 发 运行 。 
。 这 儿 段 代码 在 访问 ( 读 或 写 ) 同一 个 数据 。 
。 至 少 有 一 段 代码 在 修改 ( 写 ) 数据 。 


第 一 个 条 件 的 原因 很 容易 理解 。 如 果 整 个 代码 只 是 从 头 到 尾 地 运行 ， 没 有 任何 并 发 ， 那 就 
根本 不 用 担心 同步 问题 。 有 些 简单 的 控制 台 程序 是 这 样 的 ， 但 是 绝 大 多 数 .NET 程序 肯定 
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用 到 了 某 些 类 型 的 并 发 功能 。 第 二 个 条 件 是 说 如 果 每 段 代 码 都 有 自己 非 共 享 的 局 部 数据 ， 
那 就 不 需要 同步 。 局 部 数据 是 独立 于 其 他 代码 的 。 如 果 有 共享 数据 ， 但 数据 永远 不 会 修改 
的 话 ， 那 也 没 必 要 使 用 同步 。 第 三 个 条 件 的 情况 包括 ， 在 程序 启动 时 一 旦 设置 了 配置 参 
数 ， 就 永 不 修改 。 如 果 共 享 的 数据 只 是 用 来 读 取 的 ， 就 不 需要 同步 。 


数据 保护 是 为 了 每 段 代 码 访问 数据 时 能 得 到 一 致 的 结果 。 一 段 代码 正在 修改 数据 时 要 使 用 
同步 技术 ， 以 保证 在 系统 的 其 他 部 分 看 来 这 些 修 改 具 有 原子 性 。 

只 有 经 过 实践 才 会 知道 什么 时 候 需 要 同步 ， 因 此 在 开始 讨论 具体 方法 之 前 ， 我 们 先 看 儿 个 
例子 。 这 是 第 一 个 例子 : 

















async Task MyMethodAsync() 

{ 
int val = 10; 
await Task.Delay(TimeSpan.FromSeconds(1)); 
val = val + 1; 
await Task.Delay(TimeSpan.FromSeconds(1)); 
val = val - 1; 
await Task.Delay(TimeSpan.FromSeconds(1)); 
Trace.WriteLine(val); 


} 
如 果 从 一 个 线程 池 线 程 调 用 这 个 方法 (例如 在 Task.Run 中 运行 )， 访问 val 的 代码 行 会 在 
独立 的 线程 池 线程 中 运行 。 但 它 需 要 同步 吗 ? 不 ， 因 为 这 些 代码 行 不 会 同时 和 运行。 这 个 方 
法 是 异步 的 ,但 是 它 也 是 按 顺 序 运 行 的 (一 次 只 会 处 理 一 部 分 )。 






































好 ， 我 们 把 例子 改 复杂 一 些 。 这 次 来 运行 并 发 异步 的 代码 : 


class SharedData 


{ 
public int Value { get; set; } 

} 

async Task ModifyValueAsync(SharedData data) 

{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
data.Value = data.Value + 1; 

} 





// 警告 : 可 能 需要 同步 ， 见 下 面 的 讨论 。 
async Task<int> ModifyValueConcurrentlyAsync() 


{ 


var data = new SharedData(); 


// 启动 三 个 并 发 的 修改 过 程 。 

var task1 = ModifyValueAsync(data); 
var task2 = ModifyValueAsync(data); 
var task3 = ModifyValueAsync(data); 


await Task.WhenAll(task1, task2, task3); 
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return data.Value; 


} 


本 例 中 ， 启 动 了 三 个 并 发 运行 的 修改 过 程 。 需 要 同步 吗 ? 答案 是 “看 情况 ”。 如 果 能 确定 
这 个 方法 是 在 GUI 或 ASP.NET 上 下 文中 调用 的 (或 同一 时 间 内 只 允许 一 段 代码 运行 的 任 
何其 他 上 下 文 )， 那 就 不 需要 同步 ， 因 为 这 三 个 修改 数据 过 程 的 运行 时 间 是 互 不 相同 的 。 
例如 ， 如 果 它 在 GUI 上 下 文中 运行 ， 就 具有 一 个 UI 线程 可 以 运行 这 些 数 据 修改 过 程 ， 因 
此 一 段 时 间 内 只 能 运行 一 个 过 程 。 因 此 ， 如 果 能 够 确定 是 “同一 时 间 只 运行 一 段 代 码 ” 的 
上 下 文 ， 那 就 不 需要 同步 。 但 是 如 果 从 线程 池 线程 (如 Task.Run) 调用 这 个 方法 ， 就 需要 
同步 了 。 在 那 种 情况 下 ， 这 三 个 数据 修改 过 程 会 在 独立 的 线程 池 线 程 中 运行 ， 并 且 同 时 修 
改 data.Value， 因 此 必须 同步 地 访问 data.Value。 

































































t 


现在 我 们 把 数据 改 为 私有 成 员 ， 代 替 需 要 传递 的 变量 ， 并 且 来 看 一 个 新 的 技巧 : 





private int value; 


async Task ModifyValueAsync() 

{ 
await Task.Delay(TimeSpan.FromSeconds(1)); 
value = value + 1; 


3 


// 警告 : 可 能 需要 同步 ， 见 下 面 的 讨论 。 
async Task<int> ModifyValueConcurrentlyAsync() 
{ 

// 启动 三 个 并 发 的 修改 过 程 。 

var task1 = ModifyValueAsync(); 

var task2 = ModifyValueAsync(); 

var task3 = ModifyValueAsync(); 


await Task.WhenAll(task1, task2, task3); 


return value; 


} 


上 面 讨论 的 内 容 对 这 段 代 码 也 同样 适用 。 如 果 调 用 这 个 方法 的 是 线程 地 上 下 文 ， 那 
显然 需要 同步 。 但 这 里 还 有 一 个 技巧 。 前 一 个 例子 创建 了 在 三 个 修改 方法 中 共享 的 
SharedData 实例 。 这 个 例子 则 用 一 个 有 具体 的 私有 成 员 作为 共享 数据 。 这 意味 着 如 果 
ModifyValueConcurrentlyAsync 被 多 次 调用 ， 每 个 独立 的 调用 都 会 共享 这 个 value。 如 果 
要 避免 这 种 共享 ， 即 使 在 “同一 时 间 只 运行 一 段 代 码 ” 上 下 文中 ， 也 需要 使 用 同步 。 换 名 
话说 ， 如 果 要 在 每 次 调用 ModifyvaLueConcurrentLyAsync 之 前 等 待 前 面 的 调用 完成 ， 那 就 
需要 加 入 同步 。 即 使 上 下 文 能 够 确保 只 有 一 个 线程 来 运行 所 有 代码 〈 即 UI 线程 )， 也 是 如 
此 。 这 种 情况 下 的 同步 ， 实 际 上 是 对 异步 方法 的 一 种 限 流 ( 见 11.2 节 )。 


我 们 再 来 看 一 个 异步 例子 。 可 以 用 Task.Run 来 做 “简单 的 并 行 ”一 一 一 种 基本 的 并 行 处 
里 ， 不 像 真正 的 ParatleWPLINQ 并 行 那样 考虑 效率 和 可 配置 性 。 下 面 的 代码 用 “简单 的 





















































并 行 ”修改 一 个 共享 数据 : 


// 坏 代 码 ! ! 

async Task<int> SimpleParallelismAsync() 

{ 
int val = 0; 
var task1 = Task.Run(() => { val = val + 1; }); 
var task2 = Task.Run(() => { val = val + 1; }); 
var task3 = Task.Run(() => { val = val + 1; }); 


await Task.WhenAll(task1, task2, task3); 
return val; 


} 


线程 池 中 运行 了 三 个 独立 的 任务 (通过 Task.Run)， 都 在 修改 同一 个 变量 vaL。 这 满足 了 前 
面 讲 的 几 个 条 件 ， 毫 无 疑问 需要 同步 。 广 意 ， 即 使 val 是 一 个 局 部 变量 ， 这 段 代 码 也 需要 
同步 。 虽 然 它 是 一 个 方法 内 的 局 部 变量 ， 但 仍 被 多 个 线程 共享 。 


可 把 上 面 的 代码 改造 成 真正 的 并 行 代 码 ， 我 们 来 看 使 用 Parallel 类 的 例子 : 























void IndependentParallelism(IEnumerable<int> vaLues) 


{ 
} 


既然 用 到 了 Parallel 类 ， 那 肯定 有 多 个 线程 。 但 是 并 行 的 循环 体 (item => Trace. 
WriteLine(item)) 只 是 读 取 它 自己 的 数据 。 这 里 没有 在 多 个 线程 间 共 享 的 数据 。Parallel 
类 把 数据 分 配给 各 个 线程 ， 因 此 它们 没 必 要 共享 数据 。 每 个 线程 运行 自己 的 循环 体 ， 且 独 
立 于 运行 相同 循环 体 的 其 他 线程 。 因 此 这 段 代 码 不 需要 同步 。 


我 们 来 看 一 个 聚合 的 例子 ， 与 3.2 节 中 的 一 个 例子 类 似 ; 
// 坏 代 码 ! ! 


int ParallelSum(IEnumerable<int> values) 


{ 


Parallel.ForEach(valuyes, item => Trace.WritelLine(item)); 














int result = 0; 
Parallel.ForEach(source: values, 
localInit: () => 0， 
body: (item, state, localValue) => LocaLvaLue + item, 
localFinally: localValuye => { result += localValue; }); 
return result; 


} 


个 例子 也 使 用 了 多 线程 ， 这 次 每 ei 
or 是 把 输入 值 累 加 到 它 的 局 部 变量 ((item，state, localValue) => 
localValue + item)。 最 后 所 有 的 局 部 变 ei (localValue=> { result += 
localValue; })。 前 面 两 步 没 有 问题 ， 因 为 线程 间 还 没有 共享 数据 。 局 部 变量 和 输入 数据 
在 各 个 线程 之 间 是 互相 独立 的 。 但 是 最 后 一 个 步 又 就 有 问题 了 。 当 每 个 线程 都 把 它 的 局 部 
变量 累加 到 返回 值 时 ， 就 出 现 了 多 个 线程 访问 并 修改 同一 个 共享 变量 (result) 的 情况 。 
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因此 最 后 一 个 步骤 需要 同步 ( 见 11.1 市 )。 


PLINQ、 数 据 流 、 响 应 式 编程 库 的 情况 与 Parallel 非常 类 似 : 只 要 代码 
和 人 数据， 就 不 需要 考虑 同步 问题 。 我 发 现 只 要 正确 地 使 用 这 些 库 ， 大 多 
增加 同步 功能 。 





只 处 理 它 自己 的 输 
数 代 码 都 几乎 不 用 





最 后 我 们 来 看 一 下 集合 。 记 住 需要 同步 的 三 个 条 件 是 : 多 段 代 码 、 共 享 数据 、 修 改 数据 。 


不 可 变 类 型 本 身 就 是 线程 安全 的 ， 因 为 它们 是 不 会 改变 的 。 修 改 一 个 不 
的 ， 因 此 根本 不 需要 同步 。 例 如 下 面 的 代码 不 需要 同步 ， 因 为 每 个 独立 











可 变 集合 是 不 可 能 
的 线程 池 线程 向 本 


压 入 一 个 值 时 ， 实 际 上 是 用 这 个 值 创建 了 一 个 新 的 不 可 变 栈 ， 而 原始 栈 保持 不 变 : 


async Task<bool> PlayWithSstackAsync() 
{ 


var stack = ImmutableStack<int>.Empty; 


var task1 


Task.Run(() => Trace.NriteLine(stack.Push(3).Peek())); 


var task2 = Task.Run(() => Trace.NriteLine(stack.Push(5).Peek())); 


var task3 
await Task.WhenAll(task1, task2, task3); 





return stack.IsEmpty; // 总 是 返回 true。 


3 
但 是 ， 在 使 用 不 可 变 集合 时 通常 会 有 一 个 共享 的 “ 根 ” 变 量 ， 它 本 身 不 


Task.Run(() => Trace.NriteLine(stack.Push(7).Peek())); 


是 不 可 变 的 。 这 时 


就 必须 使 用 同步 了 。 下 面 的 代码 中 每 个 线程 向 栈 压 入 一 个 值 (同时 创建 一 个 新 的 不 可 变 
栈 )， 然 后 修改 这 个 共享 的 根 变 量 。 在 这 个 例子 中 ， 修 改 这 个 栈 变 量 时 是 需要 使 用 同步 的 : 


// 坏 代 码 ! ! 
async Task<bool> PlayWithstackAsync() 
{ 


var stack = ImmutableStack<int>.Empty; 


var taskl = Task.Run(() => { stack = stack.Push(3); }); 
var task2 = Task.Run(() => { stack = stack.Push(5); }); 
var task3 = Task.Run(() => { stack = stack.Push(7); }); 
await Task.WhenAll(task1, task2, task3); 


return stack.IsEmpty; 


} 








线程 安全 集合 (例如 ConcurrentDictionary) 就 完全 不 同 了 。 与 不 可 变 集合 不 同 ， 线 程 安 


全 集合 是 可 以 修改 的 。 线 程 安全 集合 本 身 就 包含 了 所 有 的 同步 功能 ， 因 











此 根本 不 需要 担心 


同步 的 问题 。 下 面 的 代码 ， 如 果 修 改 的 是 Dictionary 而 不 是 ConcurrentDictionary， 那 就 
需要 同步 。 但 事实 上 它 是 在 修改 ConcurrentDictionary， 因 此 就 不 需要 同步 : 











async Task<int> ThreadsafeCollectionsAsync() 


{ 





var dictionary = new ConcurrentDictionary<int, int>(); 


var task1 = Task.Run(() => { dictionary.TryAdd(2, 3); }); 
var task2 = Task.Run(() => { dictionary.TryAdd(3, 5); }); 
var task3 = Task.Run(() => { dictionary.TryAdd(5, 7); }); 


await Task.WhenAll(task1, task2, task3); 





return dictionary.Count; // 总 是 返回 3。 


} 
11.1 阻塞 锁 
问题 


多 个 线程 需要 安全 地 读 写 共享 数据 。 


决 解 方 案 
这 种 情况 最 好 的 办 法 是 使 用 Lock 语句 。 一 个 线程 进入 锁 后 ， 在 锁 被 释放 之 前 其 他 线程 是 无 
法 进入 的 : 





class MyClass 


{ 
// 这 个 锁 会 保护 _value。 
private readonly object mutex = new object(); 
private int _value; 
public void Increment() 
{ 
lock (_mutex) 
_Vvalue = valuye + 1; 
} 
} 
} 
外 * 八 
讨论 


NET 框架 中 还 有 很 多 其 他 类 型 的 锁 ， 如 Monitor、SpinLock、ReaderNriterLockSLim。 
对 大 多 数 程序 来 说 ， 这 些 类 型 的 锁 基 本 上 用 不 到 。 尤 其 是 程序 员 会 习惯 性 地 使 用 
ReaderwriterLockSLim， 即 使 没 必 要 用 那么 复杂 的 技术 。 基 本 的 Lock 语句 就 可 以 很 好 地 处 
理 99% 的 情况 了 。 


关于 锁 的 使 用 ， 有 四 条 重要 的 规则 。 
。 限制 锁 的 作用 范 目 
































ut 
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。 文档 中 写 清 锁 保护 的 内 容 。 
。 锁 范 围 内 的 代码 尽量 少 。 
。 在 控制 锁 的 时 候 绝 不 运行 随意 的 代码 。 


首先 ， 要 尽量 限制 锁 的 作用 范围 。 应 该 把 Lock 语句 使 用 的 对 象 设 为 私有 成 员 ， 并 且 永 远 不 
要 暴露 给 非 本 类 的 方法 。 每 个 类 型 通常 最 多 只 有 一 个 锁 。 如 果 一 个 类 型 有 多 个 锁 ， 可 考虑 通 
过 重 构 把 它 分 拆 成 多 个 独立 的 类 型 。 可 以 锁定 任何 引用 类 型 ， 但 是 我 建议 为 lock 语句 定义 
一 个 专用 的 成 员 ， 就 像 最 后 的 例子 那样 。 尤 其 是 千 万 不 要 用 lock(this)， 也 不 要 锁定 Type 
或 string 类 型 的 实例 。 因 为 这 些 对 象 是 可 以 被 其 他 代码 访问 的 ， 这 样 锁 定 会 产生 死 锁 。 


第 二 ， 要 在 文档 中 描述 锁定 的 内 容 。 这 种 做 法 在 最 初 编写 代码 时 很 容易 被 忽略 ， 但 是 在 代 
码 变 得 复杂 后 就 会 变 得 很 重要 。 














第 三 ， 在 锁定 时 执行 的 代码 要 尽 可 能 得 少 。 要 特别 小 心 阻 塞 调用 。 在 锁定 时 不 要 做 任何 阻 
塞 操作 。 





最 后 ， 在 锁定 时 绝 不 要 调用 随意 的 代码 。 随 意 的 代码 包括 引发 事件 、 调 用 虚拟 方法 、 调 用 
委托 。 如 果 一 定 要 运行 随意 的 代码 ， 就 在 释放 锁 之 后 运行 。 

参阅 

11.2 市 介绍 兼容 async 的 锁 。 本 节 介 绍 的 Lock 语句 与 await 并 不 兼容 。 


11.3 节 介 绍 线程 间 的 信号 。 本 市 介绍 的 Lock 语句 是 用 来 保护 共享 数据 的 ， 而 不 是 在 线程 间 
发 送信 号 。 








11.5 市 介绍 限 流 ， 它 扩大 了 锁 的 概念 。 一 个 锁 可 以 理解 为 每 次 只 允许 一 个 的 限 流 。 





11.2 异步 锁 
问题 
多 个 代码 块 需要 安全 地 读 写 共享 数据 ， 并 且 这 些 代码 块 可 能 使 用 awatt 语句。 


解决 方案 


.NET 4.5 对 框架 中 的 SemaphoreSLim 类 进行 了 升级 以 兼容 async。 可 以 这 样 使 用 : 





CLass MyCLass 


// 这 个 锁 保护 _value。 
private readonly SemaphoreSlim _mutex = new SemaphoreSLim(1); 





private int _value; 


public async Task DelayAndIncrementAsync() 


€ 
await mutex.WaitAsync(); 
try 
{ 
var oldValue = _value; 
await Task.Delay(TimeSpan.FromSeconds(oldValue)); 
_VvaLue = oldValue + 1; 
} 
finally 
€ 
_mutex .Release(); 
} 
} 


} 
不 过 ， 只 有 在 .NET 4.5 或 更 高 版 本 中 才能 以 这 种 方式 使 用 SemaphoreSlin。 

















如 果 使 用 的 是 


旧版 本 框架 或 者 是 在 编写 可 移植 类 库 ， 那 可 以 使 用 Nito.AsyncEx 库 中 的 AsyncLock 类 : 











CLass MyClass 
{ 
// 这 个 锁 保 护 _value。 
private readonly AsyncLock _mutex = new AsyncLock(); 


private int _value; 


public async Task DelayAndIncrementAsync() 
{ 


Using (await _mutex.LockAsync()) 

{ 
var oldValue = _value; 
await Task.Delay(TimeSpan.FromSeconds(oldValue)); 
_VvaLue = oldValue + 1; 


讨论 

11.1 市 中 的 规则 在 这 里 也 同样 适用 ， 包 括 : 
。 限制 锁 的 作用 范 
。 文档 中 写 清 锁 保护 的 内 容 ; 

。 锁 范 围 内 的 代码 尽量 少 ， 

。 在 控制 锁 的 时 候 绝 不 运行 随意 的 代码 。 








Es 
































确保 锁 的 实例 是 私有 的 。 不 要 暴露 到 类 的 外 面 。 确 保 文档 清晰 〈 同 时 要 做 全 而 








i 仔细 的 考虑 )， 





准确 地 描述 锁 保 护 的 内 容 。 在 控制 锁 时 执行 的 代码 要 尽量 少 。 尤 其 是 不 要 运 





行 随意 的 代码 ， 
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包括 引发 事件 、 调 用 虚拟 方法 、 以 及 调用 委托 。 各 平台 对 异步 锁 的 支持 情况 见 表 11-1。 





表 11-1: 各 平台 对 异步 锁 的 支持 





平 舍 SemaphoreSlim.WaitAsync AsyncLock 
.NET 4.5 Vv Vv 
.NET 4.0 x Vv 
Mono iOS/Droid Vv Vv 
Windows Store Vv Vv 
Windows Phone Apps 8.1 Vv WA 
Windows Phone SL 8.0 Vv WA 
Windows Phone SL 7.1 x WA 
Silverlight 5 x Vv 





AsyncLock 类 型 在 NuGet 包 Nito.AsyncEx 中 。 











参阅 
11.4 节 介 绍 了 兼容 async 的 信号 。 锁 是 用 来 保护 共享 数据 的 ， 不 能 作为 信号 。 
11.5 节 介 绍 限 流 ， 它 扩大 了 锁 的 概念 。 一 个 锁 可 以 理解 为 每 次 只 允许 一 个 的 限 流 。 


11.3 阻塞 信号 


问题 

需要 从 一 个 线程 发 送信 号 给 另 一 个 线程 。 

解决 方案 

最 常见 和 通用 的 跨 线程 信号 是 ManuaLResetEventSLim。 一 个 人 工 重 置 的 事件 处 于 这 两 种 状 


态 其 中 之 一 : 标记 的 (signaled) 或 未 标记 的 (unsignaled) 。 每 个 线程 都 可 以 把 事件 设置 为 
signaled 状态 ， 也 可 以 把 它 重 置 为 unsignaled 状态 。 线 程 也 可 等 待 事件 变 为 signaled 状态 。 


下 面 的 两 个 方法 被 两 个 独立 的 线程 调用 ， 一 个 线程 等 待 另 一 个 线程 的 信号 : 























CLass MyCLass 
{ 


private readonly ManualResetEventSlim initialized = 





new ManuaLResetEventSLim( ) ; 
private int _value; 


public int WaitForInitialization() 


{ 
_initialized.Wait(); 
return _value; 
} 
public void InitializeFromAnotherThread() 
{ 
_value = 13; 
_initialized.Set(); 
} 
} 
外 全 
讨论 


ManuaLResetEventSLim 是 功能 强大 、 通 用 的 线程 间 信号 ， 但 必须 合理 地 使 用 。 如 果 这 个 信 
号 其 实 是 一 个 线程 间 发 送 小 块 数据 的 消息 ， 那 可 考虑 使 用 生产 者 / 消费 者 队列 。 另 一 方面 ， 
如 果 信 号 只 是 用 来 协调 对 共享 数据 的 访问 ， 那 可 改 用 锁 。 




















在 .NET 框架 中 ， 还 有 一 些 不 常用 的 线程 同步 信号 类 型 。 如 果 ManuatResetEventstin 不 能 
满足 需求 ， 还 可 考虑 用 AutoResetEvent、CountdownEvent 或 Barrier。 

参阅 

8.6 节 介 绍 了 阻塞 的 生产 者 / 消费 者 队列 。 


11.1 节 介 绍 了 阻塞 锁 。 





11.4 节 介 绍 了 兼容 async 的 信号 。 


问题 
需要 在 代码 的 各 个 部 分 间 发 送 通知 ， 并 且 要 求 接收 方 必 须 进行 异步 等 待 。 
解决 方案 


如 果 该 通知 只 需要 发 送 一 次 ， 那 可 用 TaskCompletionSource<T> 异步 发 送 。 发 送 代码 调用 
TrySetResult， 接 收 代码 等 待 它 的 Task 属性 : 
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CLass MyCLass 


private readonly TaskCompletionSource<object> _initialized = 


new TaskCompletionSource<object>(); 


private int _valuel; 
private int _value2; 


public async Task<int> WaitForInitializationAsync() 


await _initialized.Task; 
return _valuel + _value2; 


public void Initialize() 


{ 
{ 
} 
{ 
} 
} 


在 所 有 情况 下 都 可 以 用 TaskCompletionsource<T> 来 异步 地 等 待 : 本 例 中 ， 通 知 来 自 于 另 一 
号 


部 分 代码 。 


_valuel = 13; 
_value2 = 17; 
_initialized.TrySetResult(nuyll); 




















如 果 只 需要 发 送 一 次 信号 ， 这 种 方法 很 适合 。 但 是 如 果 要 打开 和 关闭 信 





种 方法 就 不 大 合适 了 。 


Nito.AsyncEx 库 中 有 一 个 AsyncManualResetEvent 类 ， 基 本 上 相当 于 是 异步 的 ManualReset 








Event。 下 后 








i 是 一 个 虚拟 的 例子 ， 但 说 明了 如 何 使 用 AsyncManualResetEvent 类 





class MyClass 


private readonly AsyncManualResetEvent _connected = 


new AsyncManualResetEvent(); 


public async Task WaitForConnectedAsync() 


await _connected.WaitAsync(); 


public void ConnectedChanged(bool connected) 


{ 
{ 
} 
{ 
} 


if (connected) 
_connected. Set(); 

else 
_Connected.Reset(); 


信号 是 一 种 通用 的 通知 机 制 。 但 如 果 这 个 “信号 ”是 一 个 用 来 在 代码 段 之 间 发 送 数据 的 消 





息 ， 那 就 考虑 使 用 生产 者 / 消费 者 队列 。 同 样 ， 不 要 让 通用 的 信号 只 是 用 来 协调 对 共享 数 
据 的 访问 。 那 种 情况 下 ， 可 使 用 锁 。 


AsyncManualResetEvent 类 在 NuGet 包 Nito.AsyncEx 中 。 





参阅 

8.8 节 介 绍 了 异步 的 生产 者 / 消费 者 队列 。 

11.2 节 介 绍 了 异步 锁 。 

11.3 节 介绍 了 阻塞 信号 ， 用 于 在 线程 间 发 送 通知 。 


11.5 限 流 


问题 

有 一 段 高 度 并 发 的 代码 ， 由 于 它 的 并 发 程度 实在 大 高 了 ， 需 要 有 方法 对 并 发 性 进行 限 流 。 
代码 并 发 程度 太 高 ， 是 指 程序 中 的 一 部 分 无 法 跟 上 男 一 部 分 的 速度 ， 导 致 数据 项 累积 并 消 
耗 内 存 。 这 种 情况 下 对 部 分 代码 进行 限 流 ， 可 以 避免 占用 太 多 内 存 。 

解决 方案 

根据 代码 的 并 发 类 型 ， 解 决 方法 各 有 不 同 。 这 些 解 决 方案 都 是 把 并 发 性 限制 在 某 个 范围 之 
内 。 响 应 式 扩 展 有 更 多 功能 强大 的 方法 可 以 选择 ， 例 如 请 动 时 间 窗 口 。5.4 节 对 Rx 限 流 有 


更 完整 的 介绍 。 


数据 流 和 并 行 代码 都 自 带 了 对 并 发 性 限 流 的 方法 : 














IPropagatorBlock<int, int> DataflowMultiplyBy2() 


{ 
var options = new ExecutionDataflowBlockOptions 
{ 
MaxDegreeOfParallelism = 10 
}; 
return new TransformBlock<int, int>(data => data * 2, options); 
} 


// 使 用 PLINQ 





154 | 第 11 章 


IEnumerable<int> ParallelMultiplyBy2(IEnumerable<int> values) 


{ 
return values.AsParallel() 
.WithDegreeOfParallelism(10) 
.Select(item => item * 2); 
} 





// 使 用 Parallel 类 


void ParallelRotateMatrices(IEnumerable<Matrix> matrices, float degrees) 


( 


var options = new ParallelOptions 


{ 
上 


Parallel.ForEach(matrices, options, matrix => matrix.Rotate(degrees)); 


MaxDegreeOfParallelism = 10 


} 
并 发 性 异步 代码 可 以 用 SemaphoresSlinm 来 限 流 : 


async Task<string[]> DownloadUrlsAsync(IEnumerable<string> urls) 
{ 

var httpClient = new HttpClient(); 

var semaphore = new SemaphoreSlim(10); 

var tasks = urls.Select(async url => 


{ 
await semaphore.WaitAsync(); 
try 
{ 
return await httpClient.GetStringAsync(url); 
} 
finally 
{ 
semaphore.Release(); 
} 


}).ToArray(); 
return await Task.WhenAll(tasks); 


讨论 

如 果 发 现 程序 使 用 的 资源 (例如 CPU 或 网 络 连接 ) 太 多 ,说明 可 能 需要 使 用 限 流 了 。 需 
要 牢记 一 点 ， 最 终 用 户 的 电脑 性 能 可 能 不 如 开发 者 的 电脑 ， 因 此 限 流 得 稍微 严格 一 点 ， 比 
限 流 不 充分 要 好 。 








六 i 








参阅 
5.4 市 介绍 了 在 响应 式 代码 中 进行 限 流 。 
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代码 必须 在 某 个 线程 上 运行 。 调 度 器 (scheduler) 是 一 个 确定 代码 运行 地 点 的 对 象 。.NET 框 
架 中 有 儿 种 不 同 的 调度 器 类 型 ， 并 行 和 数据 流 代码 也 使 用 调度 器 ， 但 方式 有 些 细微 的 区 别 。 














我 建议 大 家 尽量 不 要 指定 调度 器 ， 系 统 默 认 的 调度 器 通常 是 最 合适 的 。 例 如 ， 异 步 代码 中 
的 await 操作 符 会 自动 选择 在 当前 上 下 文中 恢复 运行 ， 除非 用 2.7 节 中 描述 的 方法 覆盖 默 
认 选 项 。 类 似 地 ， 啊 应 式 代 码 引 发 事件 时 用 的 默认 上 下 文 是 很 合理 的 ， 可 以 如 5.2 苘 描述 
的 那样 ， 用 observeon 覆盖 默认 选项 。 








但 是 要 让 其 他 代码 在 指定 的 上 下 文 (如 UI 线程 上 下 文 或 ASP.NET 请 求 上 下 文 ) 中 运行 ， 
就 可 以 使 用 本 章 的 调度 技巧 来 调度 代码 。 


12.1 调度 到 线程 池 


问题 
肯定 一 段 代码 在 线程 池 线 程 中 执行 。 
解决 方案 





绝 大 多 数 情况 下 可 以 使 用 Task.Run， 它 用 起 来 很 简单 。 下 面 的 代码 阻塞 一 个 线程 池 线程 2 
秒 钟 : 


Task task = Task.Run(() => 
{ 
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Thread.Sleep(TimeSpan.FromSeconds(2)); 
}); 


Task.Run 也 能 正常 地 返回 结果 ， 能 使 用 异步 Lambda 表达 式 。 下 面 代码 中 Task.Run 返回 的 
task 会 在 2 秒 后 完成 ， 并 返回 结果 13: 


Task<int> task = Task.Run(async () => 

{ 
await Task.Delay(TimeSpan.FromSeconds(2)); 
return 13; 


和 5 
Task.Run 返回 一 个 Task (或 Task<T>) 对 象 ， 该 对 象 可 以 被 异步 或 响应 式 代 码 正常 使 用 。 


讨论 

如 果 在 UI 程序 中 有 很 耗 时 的 任务 ， 但 不 能 在 UI 线程 中 执行 该 任务 ， 这 时 使 用 Task.Run 就 
非常 合适 。 例 如 ，7.4 节 中 使 用 Task.Run 把 并 行 处 理 任务 放 到 线程 池 线程 。 但 不 要 在 ASP. 
NET 中 使 用 Task.Run， 除 非 你 有 绝对 的 把 握 。 在 ASP.NET 中 ， 处 理 请 求 的 代码 本 来 就 是 
在 线程 池 线 程 中 运行 的 ， 强 行 把 它 放 到 另 一 个 线程 池 线 程 通常 会 适得其反 。 











Task.Run 完全 可 以 末代 BackgroundWorker、Delegate.BeginInvoke 和 ThreadPool.QueueUser 

WorkItem。 新 写 的 代码 都 不 要 使 用 这 些 过 时 的 技术 ,使 用 Task.Run 的 代码 更 利于 正确 编 
写 和 日 后 的 维护 。 而 且 Task.Run 能 处 理 绝 大 多 数 使 用 Thread 类 的 场景 ， 大 多 数 情况 下 可 
以 用 Task.Run 来 代替 Thread 类 (有 极 少 数 例 外 情况 ， 如 单线 程 单元 线程 )。 


并 行 和 数据 流 代码 默认 在 线程 池 中 执行 ， 因 此 Paratlel、Parallel LINQ 或 TPL 数据 流 库 的 
代码 通常 不 需要 使 用 Task.Run。 























在 进行 动态 并 行 开 发 时 ， 一 定 要 用 Task.Factory.StartNew 来 代替 Task.Run。 因 为 根据 默 
认 配 置 ，Task.Run 返回 的 Task 对 象 适合 被 异步 调用 ( 即 被 异步 代码 或 响应 式 代码 使 用 )。 
Task.Run 也 不 支持 动态 并 行 代 码 中 普遍 使 用 的 高 级 概念 ， 例 如 父 / 子 任务 。 








参阅 
7.6 节 介 绍 如 何 用 响应 式 代 码 调用 异步 代码 (例如 Task.Run 返回 的 Task 对 象 ) 。 
7.4 节 介 绍 如 何 异 步 地 等 待 并 行 代码 ， 最 简单 的 办 法 是 使 用 Task.Run。 


3.4 节 介 绍 动态 并 行 ， 即 需要 用 Task.Factory.StartNew 代 赫 Task.Run 的 场景 。 





12.2 ”任务 调度 器 


问题 

需要 让 多 个 代码 段 按照 指定 的 方式 运行 。 例 如 让 所 有 代码 段 在 UI 线程 中 运行 ， 或 者 只 
许 特 定数 量 的 代码 段 同 时 运行 。 

本 节 介 绍 如 何 定 义 和 构 造 这 些 代 码 段 的 调度 器 。 后 面 两 节 介 绍 如 何 应 用 调度 器 。 


解决 方案 
NET 中 有 很 多 不 同 的 类 可 以 进行 任务 调度 。 本 节 重点 讲 Taskscheduter， 因 为 它 便于 移植 
使 用 起 来 也 相对 容易 。 


最 简单 的 TaskScheduler 对 象 是 Taskscheduler .Default， 它 的 作用 是 让 任务 在 线程 池 中 排 
队 。 在 代码 中 很 少 会 指定 Taskscheduler.Default， 但 是 要 特别 注意 这 个 问题 ， 因 为 它 是 调 
度 时 最 常用 的 默认 值 。Task.Run、 并 行 、 数 据 流 的 代码 用 的 都 是 TaskScheduler .Default。 




















可 以 捕获 一 个 特定 的 上 下 文 ， 然 后 用 TaskScheduler .FromCurrentSynchronizationContext 
调度 任务 ， 让 它 回 到 该 上 下 文 : 


TaskScheduler scheduler = TaskScheduler.FromCurrentSynchronizationContext(); 


这 条 语句 创建 了 一 个 捕获 当前 SynchronizationContext 的 TaskScheduler 对 象 ， 并 将 代码 
调度 到 这 个 上 下 文中 。SynchronizationContext 类 表示 一 个 通用 的 调度 上 下 文 。.NET 中 有 
几 个 不 同 的 上 下 文 ， 大 多 数 UI 框架 有 一 个 表示 UI 线程 的 SynchronizationContext，ASP. 
NET 有 一 个 表示 HTTP 请 求 上 下 文 的 SynchronizationContext。 


.NET 4.5 引入 了 另 一 个 功能 强大 的 类 ， 即 ConcurrentExclusiveSchedulerPair， 它 实际 上 是 
两 个 互相 关联 的 调度 器 。 只 要 ExclusiveScheduler 上 没有 运行 任务 ，ConcurrentScheduler 
就 可 以 让 多 个 任务 同时 执行 。 只 有 当 ConcurrentScheduler 没有 执行 任务 时 ，Exclusive 


Scheduler 才 可 以 执行 任务 ， 并 且 每 次 只 允许 运行 一 个 任务 : 








var scheduLerPair = new ConcurrentExclusiveSchedulerPair(); 
TaskScheduler concurrent = scheduLerpPair .ConcurrentScheduLer ; 
TaskScheduler exclusive = schedulerPpair.ExclusiveScheduler; 


ConcurrentExclusiveSchedulerPair 的 常见 用 法 是 用 ExclusiveScheduler 来 确保 每 次 只 
运行 一 个 任务 。Exclusivescheduler 执行 的 代码 会 在 线程 池 中 运行 ,但 是 使 用 了 同一 个 
ExcLusiveSchedutLer 对 象 的 其 他 代码 不 能 同时 运行 。 

















ConcurrentExclusiveSchedulerPair 的 另 一 个 用 法 是 作为 限 流 调度 器 。 创 建 的 Concurrent 





ExclusiveSchedulerPair 对 象 可 以 限制 自身 的 并 发 数量 。 这 时 通常 不 使 用 Exclusive Scheduler: 


var schedulerPair = new ConcurrentExcLusiveScheduLerPair(TaskScheduLer .DefauLt， 
maxConcurrencyLevel: 8); 
TaskScheduler scheduler = schedulerPair.ConcurrentScheduler; 


注意 ， 这 种 限 流 方式 只 是 对 运行 中 的 代码 限 流 ， 它 与 11.5 市 的 逻辑 上 限 流 有 很 大 区 别 。 励 
其 要 注意 ， 正 在 等 待 一 个 操作 完成 的 异步 代码 不 属于 运行 中 的 代码 。Concurrentscheduler 
对 运行 中 的 代码 做 限 流 。 其 他 限 流 方法 (如 SemaphoresLim) 在 更 高 的 层次 做 限 流 ( 即 完 
整 的 异步 方法 )。 


* * 八 

讨论 

也 许 你 已 经 注意 到 了 ， 前 面 的 示例 代码 中 ， 在 ConcurrentExclusiveSchedulerPair 的 构造 
国 数 中 传人 了 TaskScheduler.Default。 这 是 因为 ConcurrentExclusivesSchedulerPair 其 实 
是 在 一 个 已 有 的 Taskscheduler 对 象 基 础 上 实现 并 发 / 独占 逻辑 的 。 























本 节 介 绍 了 TaskScheduler.FromCurrentSynchronizationContext， 它 可 用 于 在 捕获 的 上 下 
文中 执行 代码 。 直 接 使 用 SynchoronizationContext 在 该 上 下 文中 执行 代码 也 是 可 以 的 ， 但 
是 我 建议 大 家 不 要 用 这 种 做 法 。 只 要 有 可 能 ， 就 要 使 用 await 操作 符 返 回 到 隐 式 捕获 的 上 
下 文 ， 或 者 使 用 Taskscheduler 的 封装 类 。 








在 UI 线程 上 执行 代码 时 ， 永 远 不 要 使 用 针对 特定 平台 的 类 型 。WPF、Silverlight、iOS、 
Android 都 有 Dispatcher 类 ，Windows 应 用 商店 平台 使 用 CoreDispatcher，Windows 
Forms 有 ISynchronizeInvoke 接口 ( 即 ControL.Invoke)。 不 要 在 新 写 的 代码 中 使 用 这 
些 类 型 ， 就 当 它 们 不 存在 吧 。 使 用 这 些 类 型 会 使 代码 无 谓 地 绑 定 在 某 个 特定 平台 上 。 
SynchronizationContext 是 通用 的 、 基 于 上 述 类 型 的 抽象 类 。 








响应 式 扩展 引入 了 一 个 更 通用 的 调度 器 抽象 类 : IScheduler。Rx 调度 器 能 够 封装 任何 
类 型 的 其 他 调度 器 ，TaskPoolScheduler 会 封装 任何 TaskFactory (TaskFactory 包含 了 
Taskscheduler)。Rx 还 定义 了 IScheduler 的 一 种 可 以 手动 控制 的 实现 方式 ， 用 于 测试 。 如 
果 需 要 真正 地 使 用 调度 器 抽象 类 ， 建 议 大 家 使 用 Rx 的 IScheduler。 它 具有 良好 的 设计 和 
定义 ， 测 试 起 来 也 很 方便 。 不 过 大 多 数 情况 下 并 不 需要 调度 器 抽象 类 ， 也 不 需要 使 用 早期 
的 库 (如 任务 并 行 库 和 TPL 数据 流 ) ， 只 要 掌握 Taskscheduler 类 就 行 了 。 




















参阅 
12.3 节 介 绍 如 何在 并 行 代码 中 使 用 TaskScheduler。 
12.4 节 介 绍 如 何在 数据 流 代码 中 使 用 TaskScheduter。 





11.5 市 介绍 高 层次 的 逻辑 限 流 。 
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5.2 矶 介绍 响应 式 扩 展 的 事件 流 调 度 器 。 





6.6 而 介绍 用 于 响应 式 扩展 测试 的 调度 器 。 


12.3 调度 并 行 代码 


问题 

需要 控制 个 别 代码 段 在 并 行 代码 中 的 执行 方式 。 

解决 方案 

创建 了 合适 的 TaskScheduler 实例 ( 见 12.2 节 ) 后 ， 可 以 把 它 放 入 Parallel 类 的 方法 参数 


中 。 下面 的 代码 使 用 一 系列 矩阵 的 序列 。 启 动 一 批 并 行 循 环 ， 并 且 需 要 限制 所 有 循环 的 总 
的 并 行 数量 ， 不 管 每 个 序列 中 有 多 少 和 矩阵 : 











void RotateMatrices(IEnumerable<IEnumerable<Matrix>> collections, float degrees) 
{ 
var schedulerPair = new ConcurrentExclusiveSchedulerPpair( 
TaskScheduler .Default, maxConcurrencyLevel: 8); 
TaskScheduler scheduler = schedulerPair.ConcurrentScheduler; 
ParaLLeLOptions options = new ParallelOptions { TaskScheduler = scheduler }; 
Parallel.ForEach(collections, options, 
matrices => Parallel.ForEach(matrices, options, 
matrix => matrix.Rotate(degrees))); 


} 


讨论 
Parallel.Invoke 也 能 使 用 ParaLLeLoptions 实例 ， 因 此 可 以 像 Parallel.ForEach 那样 把 


TaskSchedutLer 传 入 Parallel.Invoke。 在 编写 动态 并 行 代 码 时 ， 可 以 直接 把 TaskScheduler 
传 入 TaskFactory.StartNew 或 者 Task.ContinueWith。 


没有 什么 办 法 能 把 Taskscheduler 传 入 PLINQ 代码 。 
参阅 
12.2 市 介绍 常用 的 任务 调度 器 以 及 如 何 选 择 调 度 器 。 
si 于 由 类 人 二 刁 、 二 
12.4 用 调度 器 实现 数据 流 的 同步 


问题 
需要 控制 个 别 代 码 段 在 数据 流 代 码 中 的 执行 方式 。 
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解决 方案 

创建 了 合适 的 Taskscheduter 实例 ( 见 12.2 节 ) 后 ， 可 以 把 它 放 入 数据 流 块 的 参数 中 。 下 
面 的 代码 被 UI 线程 调用 时 ， 会 创建 一 个 数据 流 网 格 。 这 个 数据 流 网 格 将 每 个 输入 值 乘 以 2 
(用 线程 池 )， 然 后 把 结果 添加 到 一 个 列表 控件 的 项 目 中 (在 UI 线程 中 ) : 









































var options = new ExecutionDatafLowBLockOptions 
TaskScheduler = TaskScheduler.FromCurrentSynchronizationContext(), 


var multiplyBlock = new TransformBlock<int, int>(item => item * 2); 
var displayBlock = new ActionBlock<int>( 

result => ListBox.Items.Add(result), options); 
multiplyBlock.LinkTo(displayBlock); 


讨论 

如 果 要 协调 位 于 数据 流 网 格 中 不 同 部 位 的 块 的 行为 ， 就 非常 需要 指定 一 个 TaskScheduler。 
例如 ， 可 以 用 ConcurrentExclusiveSchedulerPair.ExclusiveScheduler 来 确保 块 A 和 块 C 
水 远 不 同时 执行 代码 ， 而 块 B 可 以 随时 执行 。 

记 住 ，TaskScheduler 的 同步 功能 只 有 在 代码 运行 时 才 起 作用 。 例 如 对 一 个 运行 异步 代码 
的 执行 块 启 用 一 个 独占 调度 器 ， 当 它 正在 等 待 时 ， 不 被 认为 是 在 运行 。 


可 以 对 任何 类 型 的 数据 流 块 指定 一 个 Taskscheduler。 即 使 一 个 块 可 能 执行 外 来 的 代 
码 (如 BufferBlock<T>)， 它 仍 需 要 做 一 些 内 部 协调 任务 ， 并 且 会 在 内 部 任务 中 使 用 
TaskScheduler, 





参阅 
12.2 节 介 绍 常用 的 任务 调度 器 以 及 如 何 选择 调度 器 。 
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实用 技巧 





本 章 我 们 来 看 几 个 编写 并 发 程序 时 经 常 遇 到 的 场景 ， 以 及 处 理 此 类 场景 需要 用 到 的 各 种 类 
和 技术 。 这 样 的 场景 足够 写 满 另 外 一 本 书 ， 因 此 这 里 只 选 了 几 个 最 有 用 的 来 进行 分 析 。 


13.1 初始 化 共享 资源 

问题 

程序 的 多 个 部 分 共享 了 一 个 资源 ， 现 在 要 在 第 一 次 访问 该 资源 时 对 它 初始 化 。 

解决 方案 

.NET 框架 中 有 一 个 专门 用 来 解决 这 种 问题 的 类 : Lazy<T>。 在 构造 这 个 类 的 实例 时 ， 用 一 


个 工厂 委托 (factory delegate) 进行 初始 化 。 通 过 Value 属性 使 这 个 实例 变 得 可 用 。 下 面 的 
代码 演示 了 Lazy<T> 类 : 























static int _simpleValue; 
static readonLy Lazy<int> MySharedInteger = new Lazy<int>(() => _simpleValue++); 


void UseSharedInteger() 


{ 
} 


int sharedValue = MySharedInteger .Value; 





不 管 同时 有 多 少 线程 调用 UseSharedInteger， 这 个 工厂 委托 只 会 运行 一 次 ， 并 且 所 有 线程 
都 等 待 同 一 个 实例 。 实 例 在 创建 后 会 被 缓存 起 来 ， 以 后 所 有 对 Value 属性 的 访问 都 返回 同 
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一 个 实例 〈 前 面 的 例子 中 ，MySharedInteger.VatLue 永远 是 0) 。 


如 果 初 始 化 过 程 需要 执行 异步 任务 ， 可 以 采用 一 个 非常 类 似 的 方法 。 本 例 使 用 Lazy 


<Task<T>>: 


static int _simpleValue; 
static readonly Lazy<Task<int>> MySharedAsyncInteger = 
new Lazy<Task<int>>(async () => 


{ 
await Task.Delay(TimeSpan.FromSeconds(2)).ConfigureAwait(false); 
return _simpleValuet+; 
]); 
async Task GetSharedIntegerAsync() 
int sharedValue = await MySharedAsyncInteger .Value; 
} 


本 例 中 委托 返回 一 个 Task<int> 对 象 ， 就 是 一 个 用 异步 方式 得 到 的 整数 值 。 不 管 有 多 少 代 
码 段 同时 调用 Value，Task<int> 对 象 只 会 创建 一 次 ， 并 且 每 个 调用 都 返 回 同一 个 对 象 。 每 
个 调用 者 可 以 用 await 调用 这 个 Task 对 象 ，( 异 步 地 ) 等 待 它 完 





这 种 模式 是 可 行 的， 但 还 有 一 点 需要 注意 。 这 个 异步 的 委托 可 能 在 任何 调用 Value 的 线程 
中 运行 ， 也 就 会 在 对 应 的 上 下 文中 和 运行。 如 果 有 几 种 不 同类 型 的 线程 会 调用 Vatlue (例如 
一 个 UI 线程 和 一 个 线程 池 线 程 ， 或 者 两 个 不 同 的 ASP.NET 请 求 线程 )， 那 最 好 让 委 

在 线程 池 线 程 中 运行 。 这 实现 起 来 很 简单 ， 只 要 把 工厂 委托 封装 在 Task.Run 调用 中 : 











static readonly Lazy<Task<int>> MySharedAsyncInteger = new Lazy<Task<int>>( 
() => Task.Run( 
async () => 


await Task.Delay(TimeSpan.FromSeconds(2)); 
return _simpleValuet+t+; 


})); 


Ee 
一 个 例子 是 Lazy 对 象 异步 初始 化 的 通用 模式 ， 可 惜 有 些 繁琐 。AsyncEx 库 中 有 一 个 与 


ee nt AsyncLazy<T>， 它 会 在 线程 池 中 执行 工厂 委托 。 它 也 可 以 直接 
进行 await， 声 明和 使 用 的 方法 如 下 : 





private static readonly AsyncLazy<int> MySharedAsyncInteger = 
new AsyncLazy<int>(async () => 
€ 
await Task.Delay(TimeSpan.FromSeconds(2)); 
return _simpleValuet+; 


3 





public async Task UseSharedIntegerAsync() 








{ 
int sharedValue = await MySharedAsyncInteger; 
} 
AsyncLazy<T> 类 在 NuGet 包 Nito.AsyncEx 中 。 
My 
参阅 


第 1 章 介 绍 了 async/await 方式 编程 的 基础 知识 。 


12.1 市 介绍 了 如 何 把 任务 调度 到 线程 池 。 


13.2 ”Rx 延迟 求 值 


问题 
想 要 在 每 次 被 订阅 时 就 创建 一 个 新 的 源 observable 对 象 。 例 如 让 每 个 订阅 代表 一 个 不 同 的 
Web 服务 请 求 。 


解决 方案 

Rx 库 有 一 个 操作 符 0bservable.Defer ， 每 次 observable 对 象 被 订阅 时 ， 它 就 会 执行 一 个 委 
托 。 该 委托 相当 于 是 一 个 创建 observable 对 象 的 工厂 。 下 面 的 代码 中 每 次 订阅 observable 
对 象 ， 都 会 使 用 Defer 调用 一 个 异步 方法 : 








static void Main(string[] args) 


{ 

var invokeServerObservable = Observable.Defer( 
() => GetValueAsync().ToObservable()); 

invokeServerObservable.Subscribe(_ => { }); 
invokeServerObservable.Subscribe(_ => { }); 
Console.ReadKey(); 

} 

static async Task<int> GetValueAsync() 

{ 
Console.WriteLine("Calling server..."); 
await Task.Delay(TimeSpan.FromSeconds(2)); 
Console.WriteLine("Returning result..."); 
return 13; 

} 
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将 


代码 的 输出 结果 为 : 


Calling server... 
Calling server... 
Returning result... 
Returning result... 


讨论 

应 用 程序 的 代码 一 般 不 会 多 次 订阅 一 个 observable 对 象 ， 但 有 些 Rx 操作 符 会 在 内 部 多 次 
订阅 一 个 observable 对 象 。 例 如 一 旦 条 件 满足 ，0bservable.While 操作 符 会 重新 订阅 一 个 
源 序列 。 用 Defer 可 以 让 observable 对 象 在 每 次 有 新 的 订阅 时 就 重新 求 值 。 如 果 需 要 刷新 
或 更 新 observable 对 象 的 数据 ， 就 可 以 用 这 个 方法 。 





























参阅 
7.6 节 介 绍 如 何 把 异步 方法 封装 进 observable 对 象 。 


13.3 异步 数据 绑 定 


问题 
在 异步 地 检索 数据 时 ， 需 要 对 结果 进行 数据 绑 定 〈 例 如 绑 定 到 Model-View-ViewModel 设 
计 模 式 中 的 ViewModel) 。 


解决 方案 
如 果 使 用 属性 进行 数据 绑 定 ， 这 个 属性 必须 立即 同步 地 返回 某 种 结果 。 如 果 需 要 异步 地 确 
定 实际 值 ， 那 可 以 先 返回 一 个 默认 值 ， 以 后 用 正确 值 来 更 新 这 个 属性 。 





























需要 注意 的 是 ， 异 步 操作 的 结果 可 能 是 成 功 ， 也 可 能 是 失败 。 因 为 编写 的 是 ViewModel， 
在 出 错 的 情况 下 也 可 以 用 数据 绑 定 的 方式 来 更 新 UI。 


可 以 使 用 AsyncEx 库 中 的 NotifyTaskCompletion 类 ， 


class MyViewModel 


‘ 
public MyViewModel() 
{ 
MyValue = NotifyTaskCompletion.Create(CalculateMyValueAsync()); 
} 


public INotifyTaskCompletion<int> MyValue { get; private set; } 





private async Task<int> CalculateMyValueAsync() 
{ 
await Task.Delay(TimeSpan.FromSeconds(10)); 
return 13; 


} 
可 以 绑 定 到 INotifyTaskCompletion<T> 属性 中 的 各 种 属性 ， 如 下 所 示 : 


<Grid> 
<Label Content="Loading..." 
Visibility="{Binding MyValue.IsNotCompleted, 
Converter={StaticResource BooleanToVisibilityConverter}}"/> 
<Label Content="{Binding MyValue.Result}" 
Visibility="{Binding MyValue.IsSuccessfullyCompleted, 
Converter={StaticResource BooleanToVisibilityConverter}}"/> 
<Label Content="An error occurred”Foreground="Red " 
Visibility="{Binding MyValue.IsFaulted, 
Converter={StaticResource BooleanToVisibilityConverter}}"/> 
</Grid> 


讨论 
也 可 以 自己 编号 数据 绑 定 的 封装 类 代替 AsyncEx 库 中 的 类 。 下 面 的 代码 介绍 了 基本 思路 ; 








class BindabLeTask<T> : INotifyPropertyChanged 
{ 


private readonly Task<T> _task; 


public BindableTask(Task<T> task) 
{ 

_task = task; 

var WatchTaskAsync(); 


} 


private async Task WatchTaskAsync() 


{ 
try 


{ 
} 


catch 


{ 
3 


await _task; 


OnPropertyChanged("IsNotCompleted"); 
OnPropertyChanged("IsSuccessfuLLyCompLeted " ) ; 
OnPropertyChanged("IsFaulted"); 
OnPropertyChanged("Result"); 

上 


public bool IsNotCompleted { get { return !_task.IsCompLeted; } } 
public bool IsSuccessfullyCompleted 




















将 
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{ get { return _task.Status == TaskStatus.RanToCompletion; } } 

public bool IsFaulted { get { return _task.IsFaulted; } } 

public T Result 

{ get { return IsSuccessfullyCompleted ? _task.Result : default(T); } } 


public event PropertyChangedEventHandler PropertyChanged; 


protected virtual void OnPropertyChanged(string propertyName) 


{ 
PropertyChangedEventHandler handler = PropertyChanged; 
if (handler != null) 
handler(this, new PropertyChangedEventArgs(propertyName)); 
} 


} 


注意 ， 这 里 有 一 个 空 的 catch 语句 ， 甚 目的 是 明确 地 捕获 所 有 的 异常 ， 并 且 通 过 数 
据 绑 定 来 处 理 那 些 情况 。 另 外 ， 这 里 显然 不 能 使 用 ConfigureAwait(faLtse)， 因 为 
PropertyChanged 事件 会 在 UI 线程 中 引发 。 



































NotifyTaskCompletion 类 在 NuGet 包 Nito.AsyncEx 中 。 





章 介 绍 了 async/await 方式 编程 的 基础 知识 。 


2.7 节 介 绍 了 如 何 使 用 ConfigureAwait。 


13.4 隐 式 状态 


问题 
程序 中 有 一 些 状 态 变 量 ， 要 求 在 调用 栈 的 不 同位 置 都 可 以 访问 。 例 如 ， 在 记录 日 志 时 要 使 
用 一 个 当前 操作 的 标识 符 ， 但 是 又 不 希望 把 它 作 为 参数 添加 到 每 一 个 方法 中 。 


解决 方案 
最 好 的 做 法 是 在 方法 中 增加 参数 ， 存 储 在 类 的 成 员 变量 中 ,或 者 使 用 依赖 注入 来 为 代码 的 
各 个 部 分 提供 数据 。 但 是 在 有 些 情况 下 ， 这 么 做 会 使 代码 变 得 过 于 复杂 。 


























使 用 .NET 中 CallContext 类 的 LogicalSetData 和 LogicalGetData 方法 ， 可 以 为 一 个 状态 
命名 ， 并 把 它 放 在 一 个 逻辑 “上 下 文 ” 中 。 用 完 这 个 状态 后 ， 可 以 调用 FreeNamedDataSlot 
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把 它 从 上 下 文中 移 除 。 以 下 代码 演示 了 如 何 用 这 些 方法 来 设置 操作 标识 符 ， 然 后 在 日 志方 
法 中 使 用 : 


void DoLongOperation() 


{ 
var operationId = Guid.NewGuid(); 
CallContext.LogicalSetData("OperationId", operationId); 
DoSomeStepOfOperation(); 
CallContext.FreeNamedDataSlot("OperationId"); 


void DoSomeStepOfOperation() 


// 在 这 里 记录 日 志 。 
Trace.NriteLine("In operation: "+ 
CallContext.LogicalGetData("OperationId")); 





讨论 

可 以 在 async 方法 中 使 用 逻辑 调用 上 下 文 (logical call context) ， 但 仅 限 于 .NET 4.5 和 更 高 
版 本 。 如 果 在 .NET 4.0 和 NuGet 包 Microsoft.BcL.Async 上 使 用 ， 代 码 能 够 编译 通过 但 不 
会 正确 地 运行 。 




















在 逻辑 调用 上 下 文中 ， 应 该 只 存储 不 可 变数 据 。 如 果 要 修改 逻辑 调用 上 下 文中 的 数据 ， 应 
该 重新 调用 LogicalsetData 来 覆盖 已 有 的 数据 。 





逻辑 调用 上 下 文 的 效率 不 是 特别 高 。 我 建议 大 家 只 要 有 可 能 ， 就 在 方法 中 添加 参数 或 者 把 
数据 存储 在 类 的 成 员 中 ， 而 不 是 用 隐 式 的 逻辑 调用 上 下 文 。 





在 编写 ASP.NET 程序 时 可 考虑 使 用 HttpContext.Current.Items， 它 的 功能 和 CaLLContext 
一 样 ， 但 效率 更 高 。 





参阅 


第 1 章 介 绍 了 async/await 方式 编程 的 基础 知识 。 





第 8 章 介 绍 了 儿 种 不 可 变 集合 ， 可 以 用 它们 来 存储 复杂 的 数据 ， 并 将 其 作为 隐 式 状态 。 
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本 书 封 琢 























封面 介绍 














i 的 动物 是 一 只 磨 香 猫 ， 也 称 亚洲 魔 香 猫 。 抛 开 它们 的 拉丁 文 名 字 ， 同 其 他 哺乳 动 
物 一 样 ， 它 们 也 有 两 种 不 同 的 性 别 ， 并 不 是 雌雄 同体 。 廊 香 猫 大 部 分 时 间 都 是 独居 ， 只 








在 获 殖 季节 ， 雄 性 和 雌性 才 会 聚 在 一 起 。 它 们 的 原生 地 是 东南 亚 和 印度 尼 西 亚 群 岛 ， 近 年 


也 被 引进 到 了 日 本 和 小 吴 他 群岛。 








魔 香 猫 是 一 种 小 型 的 毛皮 动物 ， 身 长 最 长 可 达 53 厘米 ， 体 重 最 多 可 重 5 千克。 它们 通常 


有 白色 或 灰色 的 斑纹 ， 头 部 有 点 像 尝 熊 。 与 其 他 灵猫 类 动物 不 同 ， 魔 香 猫 的 尾巴 是 没有 加 ® 
钵 香 猫 抵御 捕食 者 的 最 佳 武器 就 是 ， 受 到 威胁 时 肛门 处 的 气味 腺 释放 出 的 难 闻 分 泌 


环 的 。 














物 。 发 达 的 嗅觉 也 有 助 于 它们 交配 ， 雄 性 和 雌性 会 利用 气味 在 森林 里 找到 对 方 。 


靡 香 猫 是 夜间 活动 的 杂食 动物 ， 它 们 会 到 处 散播 水 果 种 子 ， 在 维护 森林 的 生物 多 样 性 上 起 
了 重要 作用 。 它 们 特别 喜欢 喝 标 榈 花 的 汁液 ， 这 种 并 液 在 发 酵 后 就 成 为 甜美 的 标 榈 酒 ， 它 
们 因此 赢得 了 “棕榈 酒 猫 ” 的 绰号 。 在 一 些 地 方 ， 特 别 是 中 国 南 部 ， 人 们 为 了 吃 肉 而 捕 
杀 靡 香 猫 。 但 其 实 对 廊 香 猫 种 群 最 大 的 威胁 ， 是 人 们 为 了 生产 猫 屎 咖啡 而 捕捉 野生 魔 香 
猫 。 猫 屎 咖啡 是 用 经 过 麻 香 猫 消 化 并 排泄 的 咖啡 豆 制 作 的 ， 传 统制 作 过 程 用 到 了 野生 动物 
的 装 便 。 喝 这 种 咖啡 的 人 越 来 越 多 ， 导 致 良 香 猫 被 捕捉 并 关 在 大 农场 的 小 笼子 里 ， 只 能 吃 



































咖啡 豆 ， 不 能 运动 ， 也 不 能 到 野外 活动 。Tony Wild 是 负责 把 猫 屎 咖啡 传播 到 西方 的 营销 





经 理 


» 


[a 





上 于 动物 保护 的 原因 








， 现 在 他 反对 这 种 做 法 ， 并 发 起 了 一 场 名 为 “ 停 用 辩 便 ”(Cut 


the Crap) 的 运动 ， 以 停止 它 的 使 用 。 


封面 图 片 取 自 Lydekker 的 《皇家 自然 史 》。 
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C# 并 发 编程 经 典 实例 


并 发 编程 在 响应 式 和 可 扩展 的 应 用 开发 中 得 到 了 日 益 广泛 的 应 用 。 但 
并 发 编程 的 难度 曾经 非常 大 ， 令 众多 开发 人 员 望 而 却步 。 今 天 ， 很 多 更 
高 层 抽象 的 现代 程序 库 的 出 现 ， 大 大 降低 了 并 发 编程 的 难度 。 本 书 使 
用 .NET 4.5 和 C# 5.0 中 的 语言 特性 ， 展 示 并 行 处 理 和 异步 编程 技术 。 
本 书 既是 一 本 入 门 指导 书 ， 也 是 一 本 快捷 参考 书 ， 它 示例 丰富 、 结 构 独 
特 ，70 多 个 源 代 码 示例 ， 完 整 的 “问题 一 解决 方案 一 讨论 ”模式 ， 逐 渐 
深入 又 自 成 一 体 。 你 可 以 循序 渐进 地 学 习 本 书 内 容 ， 也 可 以 直接 查阅 对 
应 的 示例 ， 迅 速 解决 手头 的 问题 。 

本 书 主要 内 容 : 

国 面向 异步 编程 的 async 和 await 

国 使 用 TPL (任务 并 行 库 ) 

国 创建 数据 流 管道 的 TPL Dataflow 库 

国 基于 LINQ 的 Reactive Extensions 

国 为 并 发 代码 编写 单元 测试 

国 并 发 方法 之 间 的 互 操作 

四 不 可 变 、 线 程 安全 和 生产 者 /消费 者 集合 

国 并 发 代码 中 的 取消 功能 支持 

国 支持 异步 的 面向 对 象 编程 

国 线程 同步 访问 数据 





Stephen Cleary C# MVP， 知 名 软件 开发 人 员 ， 在 C#、C++、JavaScript 等 方 
面 均 有 丰富 的 经 验 。1998 年 起 成 为 专业 软件 开发 人 员 ， 涉 猎 广 泛 ， 从 ARM 
固件 到 Azure 样 样 精通 。 他 从 最 初 的 Boost C++ 库 开 始 就 在 为 开源 软件 做 贡 
献 ， 并 且 发 布 了 几 个 他 自己 的 库 和 工具 。Stephen 喜 欢 演讲 和 写作 ， 在 其 个 
人 网 站 http:/stephenclearycom/ 上 ,， 有 大 量 受 欢迎 的 博客 文章 以 及 开源 库 和 
应 用 。 


“涵盖 各 种 并 发 编程 技术 ， 本 书 体 


例 必然 成 就 其 为 现代 .NET 并 发 
技术 的 理想 参考 书 。” 

Jon Skeet 

谷歌 高 级 软件 开发 工程 师 ， 

StackOverflow 排 名 第 一 

的 杰出 程序 员 ， 

著 有 《深入 理解 C#》 





“让 普通 人 利用 大 规模 并 行 能 力 是 


计算 领域 的 一 大 趋势 。 与 以 前 
相 比 ， 开 发 人 员 已 经 能 更 好 地 
掌握 并 发 技术 ， 但 要 把 并 发 讲 
清楚 对 很 多 人 仍然 是 一 项 巨大 
的 挑战 。Stephen 专 注 于 这 个 领 
域 ， 通 过 这 本 易 读 、 完 整 的 参 
考 手册 ， 帮 助 我 们 更 好 地 理解 
并 发 、 线 程 、 反 应 式 编程 模型 、 
并 行 等 主题 。” 
一 一 Scott Hanselman 
微软 ASPNET 及 
Azure Web Tools 首 席 项 目 经 理 
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看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 或 作 译 者 协助 
答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : ebook@turingbook.com。 
在 这 里 可 以 找到 我 们 : 
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